Panel Name

fwDipEditDptCreate.pnl

Introduction
This panel is used to subscribe to complex DIP publications. It allows to specify the matching of the dpes and the DIP tags, create new DPT and create the instances of given DPTs.

The panel contains the mechanisms to perform the type chcecking between DIP types and dpe types.

Instructions The central section of the panel is filled with a table which shows the structure of the publication. The table has following columns:
  • DIP Tag - contains the names of the publication fields
  • Datatype - contains the user-friendly name of the datatype
  • Datapoint Element - contains the name of the dpe of selected DP to which the given DIP tag will be subscribed.

The upper part of the panel is devoted to selection and creation of DPTs and DPs. Here follows the description of the elements:

  • DPT selection box: Contains all the DPTs selected according to the criteria choosen from the radio buttons. The DPTs are being selected from DIP designated DPTs (prefixed with DIP).
  • DP selection box: Contains all the DPs of the selected DPT that can be used for the subscription purposes.
  • Create DPT button: Clicking this will prompt a user for the name of the DPT to create. The created DPT will have the structure matching the structure of the DIP publication.
  • Create DP button: Clicking this will prompt a user for the name of the DP to create. The created DP will be of currently selected DPT.
  • Radio buttons:
    • Matching DPT: will list all the DPTs which have dpes that match fields of DIP publication - both names and types must match. The DPT can have additional dpes - they are not taken into account.
    • Compatible DPT: will list all the DPTs which have enough dpes of each of the publication field type. (e.g. publication has 4 integer fields and 3 boolean fields, thus DPT with 5 integer dpes, 5 boolean fields is compatible).
    • All DPT: will list all the DPTs.

Clicking on any row in the table will pop up the panel in which one can manually select which dpe will be used for subscribing to given field.

Changing the DPT will clear the entries in the "Datapoint Element"

The bottom part of the panel contains the buttons:

  • Fill matchin dpes: fill the table - will fill the "Datapoint Element" column for rows, where both names and types in dpe and DIP publication match.
  • Clear: clear the "Datapoint Element" column of the table
  • Subscribe: proceed with subscription according to chosen settings
  • Cancel: abort the creation of subscription

Restrictions To update the list of current configuration data points, you must manually press the "Refresh" button.  This is important to ensure that you are viewing the latest information.

 

Panel screenshot

 

 

Dollar Parameters
Name Description  
$sConfigDp Contains the DIP API Manager config DP - which is needed to execute a DIP query. Required
$sDipPublicationName The name of the DIP publication that we want to subscribe to. Required