The Method RequestResults is used to receive stored results from the Server. A joining system can send live results or stored results.
The successful execution of this method will generate instances of RequestedResultEventType and update RequestedResultVariable.
The signature of this Method is specified below. Table 58 and Table 59 specify the Arguments and AddressSpace representation, respectively.
Signature
RequestResults (
[in]0:UInt64fromSequenceNumber,
[in]0:UInt64toSequenceNumber,
[in]0:UtcTimefromTime,
[in]0:UtcTimetoTime,
[in]0:DurationrequestedMinimumDurationBetweenResults,
[out]0:DurationrevisedMinimumDurationBetweenResults,
[out]0:Int64status,
[out]0:LocalizedTextstatusMessage)
Table 58 – RequestResults Method Arguments
Argument |
Description |
fromSequenceNumber |
The starting sequence number for the Requested Results.
It is a required argument if results are requested based on the input sequence number range.
It shall be a valid value > 0. If 0, then fromTime and toTime are used. |
toSequenceNumber |
The ending sequence number of the Requested Results.
It is a required argument if results are requested based on the input sequence number range.
It shall be a valid value > 0 and shall be >= fromSequenceNumber. If 0, then fromTime and toTime are used. |
fromTime |
It is the start time for the Requested Results.
This argument is considered only when fromSequenceNumber and toSequenceNumber are set as 0. |
toTime |
It is the end time for the Requested Results.
This argument is considered only when fromSequenceNumber and toSequenceNumber are set as 0. |
requestedMinimumDurationBetweenResults |
The client can use this argument to configure a time interval between each Result to optimize the number of Results sent from the Server.
The Server can return the revised interval if the requested interval is not supported.
Note: It is only a requested minimum time interval by the client and the server could take additional time for processing. |
revisedMinimumDurationBetweenResults |
It is the minimum revised interval supported by the server. |
status |
It provides the status of the Method execution. Refer 7.4 for details. |
statusMessage |
It provides the high-level status information in a user-friendly text. |
Table 59 – RequestResults Method AddressSpace Definition
Attribute |
Value |
||||
BrowseName |
RequestResults |
||||
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
0:HasProperty |
Variable |
0:InputArguments |
0:Argument[] |
0:PropertyType |
0:Mandatory |
0:HasProperty |
Variable |
0:OutputArguments |
0:Argument[] |
0:PropertyType |
0:Mandatory |