Pablo Benvenuto

Learning Lab - Building AF Displays Part 1

Discussion created by Pablo Benvenuto Champion on Aug 24, 2012

So now you have PI AF and you or somebody else in your organization created an AF database with a configuration that contains different pieces of equipment from your plant. I will show you how to build a display in ProcessBook using that configuration to monitor the elements that it contains.

You can follow this lab by using your production environment and one of your existing AF databases or you can obtain a subscription to the OSIsoft Virtual Learning Environment, which contains an AF database called Tank Farm and a configuration of four tanks from a ficticious plant. This is a picture of the AF database and the configuration of four tanks.


You can obtain more information about the OSIsoft Virtual Environment here. When we are done, the display will look like the picture below.


You will need to use the PI ProcessBook Modeler add-in to access the information contained in the AF database and build the display. First you will have to connect to the AF database and then drag and drop the elements and attributes on the display using the AF Browser and AF Property windows. You will then assign tank symbols from the symbol library to the different tank templates.

Create a new display

Click on File > New to create a new display in PI ProcessBook. Select "ProcessBook Display" and type the name "Tank
. Click OK. Now you can open the "AF Browser" and "AF Property" windows. Click on View > AF Property and on View > AF Browser. If you are not already connected to the AF database, you can connect now using the "AF Browser" window. Click on the ellipsis (...) button.

Select the right PI System, PI-System-2010. Click on the desired database, in my case "Tank Farm". Click OK. Make sure you are in "Build Mode". Have you worked with PI ProcessBook before? Do you need help creating a display? Click here and check out this previous lab on creating displays.


Under the "AF Browser" window you can now see the four tanks. Click on the Template tab and you can also see the tank templates that are configured in the database (Tank_Alpha, Tank_Bravo and Tank_Charlie). In the Elements tab, select each one of the tanks and see what template they are using in the General tab of the AF Property window.

Tank_ERY623: Tank_Charlie
Tank_FGT657: Tank_Alpha
Tank_FGT658: Tank_Alpha
Tank_KLR231: Tank_Bravo

Add static elements

You can now add static elements to your display to represent your elements, you must be in "Build Mode" for this. I will add a tank to the display from the Symbol Library. Click on Draw > Symbol Library.

Now draw a rectangle by dragging your mouse in the display area. The tank will fill this rectangle, but you will be able to resize it and move it around later. A dialog box will appear with all the items from the "Symbol Library". Select the "Tanks" category, and select "Tank 24". Now Right click on the symbol and select the Assign Symbol to Template option to assign that symbol to every tank based on the Tank_Alpha template. Click OK and accept the overwrite confirmation message.

This concludes the first part of this lab. If you want to know what comes next, go on to Part 2.

If you would rather watch the lab in video format, go to the OSIsoft Learning Channel and search for "Building PI AF displays" in the channel.

If you would like to learn more about PI AF, you might want to consider watching the following playlist from the Learning Channel: