Skip to main content

Configure IF Virtual Data Set

To configure an IF Virtual Data Set:

  1. Run the Integration Framework - Configurator application.

    The Integration Framework - Configurator window opens.Figure 1430: Configurator - Configured Data Server pane, select Virtual Data Server

  2. In the Configured Data Server pane, click on the VIRTUAL Data Server to which you want to add a Data Set.

  3. In the toolbar, click the Add icon.

    Alternatively, you can right-click on the PI Server and select the Add option as shown in the following figure.Figure 1431: Right-click menu, Add option

    The Configure Virtual Data Server Source window opens.Figure 1432: Configure Virtual Data Server Source window

    Before you can work in this window, you need to activate the "Available Sources" panel. The panel allows you to select the IF objects to be consumed and used to feed an IF object.

  4. In the toolbar, click the Virtual Data tree icon to expand the Data Server tree.Figure 1433: Virtual Data Source - Data Set selection

  5. Locate and select the Data Set to be consumed and drag it onto the right panel (as shown in Figure 1433).

    In our example, we have used the OLE DB Data Set (DS_Transfers), in order to import them into our PI Data Server (PIMS901-MI).

  6. Locate and select the Data Server into which the Data Set is to be consumed and drag it onto the right panel, as shown in the following figure.Figure 1434: Virtual Data source - Destination Data Server selection

    The next step is to connect the source OLE Database Data Set (in our example, DS_Transfers) to the destination PI Data Server (in our example PIMS902-MI). This is done by selecting a row in the Data Set window and dragging it over the PI Data Server icon.

  7. Select one of the rows in the Data Set and drag it onto the top of the Data Server connection icon, as shown in the following figure.Figure 1435: Virtual Data source - connect Data Set to Data Server

    When the connection completes successfully, a connector is displayed, as shown in the following figure.Figure 1436: Connection between Data Set and Data Server

  8. Double-click on the PI Server connection icon to activate the settings window.Figure 1437: Setting how to behave on AF Data Base window

    In this window you set up the preliminary setting of the connected PI Data Server.

  9. In the pane on the left, select the Sigmafine database in which to import the transfers.

  10. Under Update Modality, select the Insert and update option.

  11. Click on the Synchronize Transfers tab to open its panel.Figure 1438: Setting how to behave on AF Data Base - Synchronize Transfers tab

  12. Click on the Select the template down-arrow, and select the appropriate template to be used to create the transfers (in our example this would be the SF_TransferTemplate).

    Next, you need to map the Data Set column that contains the transfer's name.Figure 1439: Map Data Set transfer's name column to Name item

  13. Click on the Transfer Name down-arrow and select the Name item.

    This action maps the Transfer Name to the Name item. Now you need to map the Data Set columns containing the transfer source, destination, start time and end time.Figure 1440: Map Data Set source & start time and destination & end time columns to appropriate items

  14. Click the Source down-arrow and select the Source item.

  15. Click the Start time down-arrow and select the StartTime item.

  16. Click the Destination down-arrow and select the Dest item.

  17. Click the End time down-arrow and select the EndTime item.

    Now you define where to store the Data Set column 'Mass' in the transfer attribute.Figure 1441: Define storing of 'Mass' Data Set column

  18. Check the Mass checkbox.

  19. Click on the Mass, Attribute Name cell down-arrow and select MeasuredMass.

    Next, you assign a name to the configured action.Figure 1442: Assign name to configured action

  20. In the Action Name box, type a name for the configured action.

  21. Click the Save and Exit icon.

    You are returned to the Configure Virtual Data Server Source window, Virtual Data Source tab.

  22. Click the Save and Exit icon in the Virtual Data Server Source window, to save the Virtual Data Server.

    You are returned to the Virtual data set settings window, where you assign a name to the Data Set.Figure 1443: Virtual data set settings window

  23. In the Data Set Name box, type a name for the Data Set.

  24. Click OK to save the new Data Set and return to the Integration Framework - Configurator main window.

    The Data Set you just saved is now displayed in the VIRTUAL tree in the Configured Data Server pane.Figure 1444: Virtual Data Set displayed

    The last action is to test the Virtual Data Set.

  25. In the configured Data Server pane, locate and click on the Virtual Data Set you just configured, to select it.

  26. In the toolbar, click on the Preview icon.

    A preview of the input OLE DB Data Set is displayed, and the configured action over the AF Data Base is performed. The results are displayed in the VirtualPreviewSequence window, as shown in the following figure.Figure 1445: VirtualPreviewSequence window