Configuring Describe Service
Prerequisite:
Before you configure adapter services, ensure that you have completed the steps mentioned in
Preparing to Configure and Manage Adapter
Services.
A Describe service retrieves the node references from the OPC UA server. You must configure
Adapter for OPC services using
Software AG Designer. For more information about adapter services, see
Using Adapter Services.
![*](icon_task_xpe.png)
To configure a Describe service
1. In Software AG Designer, right click the package in which the service should be contained and select File > New > Adapter Service.
2. Select the service from the list of elements. Click Next.
3. Select the Adapter for OPC as the adapter type. Click Next.
4. Select the appropriate Adapter Connection Name. Click Next.
5. In the list of available templates, select the Describe template. Click Finish.
In the adapter service editor, select the Adapter Settings tab to confirm adapter service properties such as Adapter Name, Adapter Connection Name, and Adapter 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 |
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. The selected node has the following fields:
Field | Description/Action |
Attribute Name | Lists all the attributes supported by the selected node. |
Attribute Value | Show the corresponding attribute value. |
8. Select Configuration tab to specify the filter for output information:
Field | Description |
Browse Direction | Forward. Output result lists only forward references. Inverse. Output result lists only inverse references. Both. Output result lists both Forward and Inverse references. |
Reference Type | Hierarchical. Output result lists all references that have type hierarchical or subtype hierarchical . NonHierarchical. Output result lists all references that have type NonHierarchical or subtype NonHierarchical. Both. Output result lists both Hierarchial and NonHierarchical. references. |
Include SubType | If selected, the output result includes references of SubType of selected Reference Type. If not selected, the output result lists only references of the Reference Type selected. |
Node Class | To filter the references according to the target node's class type. If Unspecified, the filter is not be applicable. |
Max Reference Returned | Specify the number of references you want to receive when you execute a service. Specifying zero returns all the results. |
9. From the File menu, select Save (or Save All).