Configuring Read Service
Prerequisite:
Before you configure adapter services, ensure that you have completed the steps mentioned in
Preparing to Configure and Manage Adapter
Services.
A Read service retrieves a node value from the OPC UA server. You can configure
Adapter for OPC services using
Software AG Designer. For more information about adapter services, see
Using Adapter Services.
To configure a Read service
1. In Software AG Designer, right click the package in which the service is contained and select File > New > Adapter Service.
2. Select the service from the list, provide the Element name. Click Next.
3. Select Adapter for OPC as the adapter type. Click Next.
4. Select the appropriate Adapter Connection Name. Click Next.
5. Select the template for the unique service name. Click Finish.
In the adapter service editor, select the Adapter Settings tab to confirm adapter service properties such as Adapter Name, Adapter Connection Name, andAdapter Service Template, as necessary.
6. In Node Attributes tab, click Browse to navigate and find the node. The following fields are available in the Node Selector tab :
Field | Description |
Search Node | Searches the node. Note: This is mainly for the nodes that are available but not visible due to Tree View Level control in Adapter Service Preference. For more information on Adapter Service Preference, see webMethods Service Development Help. |
After selecting the node from Node Selector, the selected node appears in the Extended Node Id. The following fields are available in Node Attributes tab:
Field | Description/Action |
Extended Node Id | Displays the extended node id of the selected node. The node id is represented in the following format: nsu=<namespace uri>; Id type=Id value |
Node Id | Displays the node id of the selected node. |
Use Dynamic Node | Provides node id at run-time. This option displays all the attributes supported by OPC UA server. Note: This option takes priority over the selected node. |
In Adapter Tree Viewer, right click on a node to view the following menu options:
Menu Option | Description |
Set As Root | Use to set a node in the Tree-View as the root node. To view the hidden nodes in the tree view, set a node as a root node. |
Copy Node Id | Use to copy the node's id from the tree view. |
Copy Node Details | Use to copy the node's details from the tree view. |
7. To select attributes that retrieve value from the OPC UA server.
Field | Description |
Field Name | Lists all the attributes supported by the selected node. |
Use Field | To select the field you want to read. |
The value field is applicable only if the attribute is of value type.
Field | Description/Action |
Value Field Native Type | Displays the built-in type and complex data types of the value attribute that the OPC UA server supports. |
Value Field Output Type | Displays all the supported Java data types for built-in type. Displays java.lang.Object, Document or DocumentList for complex data types. |
8. To verify input or output information for this service, use the Input/Output tab as needed.
If the Value Field Output Type is of type Document or DocumentList, then the output value displays the structure for corresponding the Document or DocumentList.
9. From the File menu, select Save.