About Discover “Include” options

Starting in the AX-3.2, the Obix R2 points discovery behavior was improved, and new properties were added to the Points device extension (R2PointsDeviceExt). Improvements made include the following:

All R2 container-type objects, including types Container, Bundle, PollOnDemand, and PollAlways appear in the discovered lobby tree as “groups” (gray rows)—you still expand them to see child objects. If you double-click (to add), an Obix Point Folder is immediately created, without an intervening popup dialog.
By default, all R2 Gx objects (GxText, GxFan, and so on) are omitted from the discovered lobby tree, although GxPage containers still appear. This is controlled by the setting of the property of the Points extension of the parent R2ObixClient: Include Ui Nodes (default value is false). It is recommended to be left at default.
By default (if the associated R2 host has the file nre/lib/obixInternal.properties installed), all named properties of R2 objects are globally omitted from the AX discovered lobby tree, typically those rarely adjusted (if ever) during normal R2 configuration. On the AX side, this is controlled by the setting of the property of the Points extension of the parent R2ObixClient: Include Internal Props (default value is false). If you need AX access to these properties, set this slot to true.
Note the R2 “shipped” version of obixInternal.properties contains a minimal list of properties—you can edit this file to add more properties, one per line. Driver-specific properties, such as LON props and so on, are not included.

If the R2 host does not have the obixInternal.properties file installed, or its station has not been restarted since that file was installed, the value of the “Include Internal Props” property makes no difference—all properties are included in any AX point discovery for that R2ObixClient.

Figure 2-12 shows the property sheet for the Points extension of an R2ObixClient, including the default settings for the two “Include” in discovery properties.

About Discover “Include” options

Figure 20. R2PointsDeviceExt property sheet with Include defaults

Related Links