This Service is used to discover the References of a specified Node. The browse can be further limited by the use of a View. This Browse Service also supports a primitive filtering capability.
In some cases it may take longer than the Client timeout hint to process all nodes to browse. In this case the Server may return zero results with a continuation point for the affected nodes before the timeout expires.
Table 34 defines the parameters for the Service.
Table 34 – Browse Service Parameters
|
Name |
Type |
Description |
||||||||||||||||||
|
Request |
|
|
||||||||||||||||||
|
requestHeader |
RequestHeader |
Common request parameters (see 7.33 for RequestHeader definition). |
||||||||||||||||||
|
View |
ViewDescription |
Description of the View to browse (see 7.45 for ViewDescription definition). An empty ViewDescription value indicates the entire AddressSpace. Use of the empty ViewDescription value causes all References of the nodesToBrowse to be returned. Use of any other View causes only the References of the nodesToBrowse that are defined for that View to be returned. |
||||||||||||||||||
|
requestedMax ReferencesPerNode |
Counter |
Indicates the maximum number of references to return for each starting Node specified in the request. The value 0 indicates that the Client is imposing no limitation (see 7.8 for Counter definition). |
||||||||||||||||||
|
nodesToBrowse [] |
BrowseDescription |
A list of nodes to Browse. This structure is defined in-line with the following indented items. |
||||||||||||||||||
|
nodeId |
NodeId |
NodeId of the Node to be browsed. If a view is provided, it shall include this Node. |
||||||||||||||||||
|
browseDirection |
Enum BrowseDirection |
An enumeration that specifies the direction of References to follow. The enumeration is defined in 7.5. The returned References do indicate the direction the Server followed in the isForward parameter of the ReferenceDescription. Symmetric References are always considered to be in forward direction therefore the isForward flag is always set to TRUE and symmetric References are not returned if browseDirection is set to INVERSE. |
||||||||||||||||||
|
referenceTypeId |
NodeId |
Specifies the NodeId of the ReferenceType to follow. Only instances of this ReferenceType or its subtypes are returned. If not specified then all References are returned and includeSubtypes is ignored. |
||||||||||||||||||
|
includeSubtypes |
Boolean |
Indicates whether subtypes of the ReferenceType should be included in the browse. If TRUE, then instances of referenceTypeId and all of its subtypes are returned. |
||||||||||||||||||
|
nodeClassMask |
UInt32 |
Specifies the NodeClasses of the TargetNodes. Only TargetNodes with the selected NodeClasses are returned. The NodeClasses are assigned the following bits:
If set to zero, then all NodeClasses are returned. If the NodeClass is unknown for a remote Node, the nodeClassMask is ignored. |
||||||||||||||||||
|
resultMask |
UInt32 |
Specifies the fields in the ReferenceDescription structure that should be returned. The fields are assigned the following bits:
The ReferenceDescription type is defined in 7.30. |
||||||||||||||||||
|
|
|
|
||||||||||||||||||
|
Response |
|
|
||||||||||||||||||
|
responseHeader |
Response Header |
Common response parameters (see 7.34 for ResponseHeader definition). |
||||||||||||||||||
|
results [] |
BrowseResult |
A list of BrowseResults. The size and order of the list matches the size and order of the nodesToBrowse specified in the request. The BrowseResult type is defined in 7.6. |
||||||||||||||||||
|
diagnosticInfos [] |
Diagnostic Info |
List of diagnostic information for the results (see 7.12 for DiagnosticInfo definition). The size and order of the list matches the size and order of the results response parameter. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request. |
Table 35 defines the Service results specific to this Service. Common StatusCodes are defined in Table 182.
Table 35 – Browse Service Result Codes
|
Symbolic Id |
Description |
|
Bad_ViewIdUnknown |
See Table 182 for the description of this result code. |
|
Bad_ViewTimestampInvalid |
See Table 182 for the description of this result code. |
|
Bad_ViewParameterMismatchInvalid |
See Table 182 for the description of this result code. |
|
Bad_ViewVersionInvalid |
See Table 182 for the description of this result code. |
|
Bad_NothingToDo |
See Table 182 for the description of this result code. |
|
Bad_TooManyOperations |
See Table 182 for the description of this result code. |
Table 36 defines values for the results parameter that are specific to this Service. Common StatusCodes are defined in Table 183.
Table 36 – Browse Operation Level Result Codes
|
Symbolic Id |
Description |
|
Bad_NodeIdInvalid |
See Table 183 for the description of this result code. |
|
Bad_NodeIdUnknown |
See Table 183 for the description of this result code. |
|
Bad_ReferenceTypeIdInvalid |
See Table 183 for the description of this result code. |
|
Bad_BrowseDirectionInvalid |
See Table 183 for the description of this result code. |
|
Bad_NodeNotInView |
See Table 183 for the description of this result code. |
|
Bad_NoContinuationPoints |
See Table 183 for the description of this result code. |
|
Uncertain_NotAllNodesAvailable |
Browse results may be incomplete because of the unavailability of a subsystem. |