Difference between revisions of "Extensions.Measure.ExecuteDeviceService"
Jump to navigation
Jump to search
| Line 14: | Line 14: | ||
{| {{TableHeader}} | {| {{TableHeader}} | ||
{{TableRowPropertiesHeader}} | {{TableRowPropertiesHeader}} | ||
| − | {{ | + | {{TableRowPropertie2| executeAsync | [[Core.DataTypes.SimpleDataType.Boolean|Boolean]] | [[Value]] | false | [0..1] | This option tells the communication backend to make this device service execution non-blocking. This means that if '''executeAsync''' is set to '''true''', the OTX execution flow will immediately move on to the next '''Action''', without waiting for the result of the '''ExecuteDeviceService''' action.}} |
| − | next Action, without waiting for the result of the '''ExecuteDeviceService''' action. }} | + | {{TableRowPropertie1| suppressInvalidMeasurementException | [[Core.DataTypes.SimpleDataType.Boolean|Boolean]] | [[Value]] | false | [0..1] | This flag shall affect only those device services which declare [[Extensions.Measure.InvalidMeasurementException|InvalidMeasurementException]] in their '''<throws>''' block. For other device services, it shall have no effect.}} |
| − | {{ | + | {{TableRowPropertie2| Device | [[OtxLink]] | - | - | [1] | This attribute identifies the measurement device to execute the service on. The link shall point to the corresponding '''DeviceSignature''' for that device.}} |
| − | {{ | + | {{TableRowPropertie1| Service | [[OtxName]] | - | - | [1] | Identifies the service which shall be executed. The service name shall be defined within the corresponding service declaration within the '''DeviceSignature'''.}} |
| − | {{ | + | {{TableRowPropertie2| Arguments | DeviceServiceArguments | - | - | [0..1] | The content-type of this simple container element is '''<xsd:choice> [1..*]''' which allows an arbitrarylength list of in- and output arguments for the to-be-executed device service's parameters.}} |
| − | {{ | ||
|} | |} | ||
== OTL Examples == | == OTL Examples == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| + | /// Signatures | ||
| + | |||
package Measure.DeviceSignature DeviceSignature1 | package Measure.DeviceSignature DeviceSignature1 | ||
{ | { | ||
| − | + | Measure.DeviceServiceSignature DeviceServiceSignature1(in Integer DeviceServiceInParameter1, out String DeviceServiceOutParameter1); | |
} | } | ||
| + | |||
| + | /// Global Declarations | ||
public procedure main() | public procedure main() | ||
{ | { | ||
| − | + | /// Local Declarations | |
| − | + | ||
| + | /// Flow | ||
| + | |||
| + | Measure.ExecuteDeviceService(DeviceSignature1, DeviceServiceSignature1, {DeviceServiceInParameter1 = 4, DeviceServiceOutParameter1}, false, false); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== See also == | == See also == | ||
[[Core.Signatures.DeviceSignatures|DeviceSignature]] | [[Core.Signatures.DeviceSignatures|DeviceSignature]] | ||
Revision as of 03:48, 19 October 2018
Classification
| Name | ExecuteDeviceService |
| Short Description | Executes a service provided by a measurement device. |
| Class | Action |
| Extension | OTX Measure extension |
| Group | Measure related actions |
| Exceptions | - |
| Checker Rules | Core_Chk053 Measure_Chk001 Measure_Chk002 Measure_Chk003 Measure_Chk004 Measure_Chk005 |
| Standard Compliant | Yes |
OTL Syntax
Measure.ExecuteDeviceService(OtxLink, OtxName, {DeviceServiceArguments}, BooleanTerm executeAsync, boolean, boolean);Description
The ExecuteDeviceService action shall execute a service provided by a measurement device. The action connects to physical devices from where it retrieves measurements.
Properties
| Name | Data Type | Class | Default | Cardinality | Description |
| executeAsync | Boolean | Value | false | [0..1] | This option tells the communication backend to make this device service execution non-blocking. This means that if executeAsync is set to true, the OTX execution flow will immediately move on to the next Action, without waiting for the result of the ExecuteDeviceService action. |
| suppressInvalidMeasurementException | Boolean | Value | false | [0..1] | This flag shall affect only those device services which declare InvalidMeasurementException in their <throws> block. For other device services, it shall have no effect. |
| Device | OtxLink | - | - | [1] | This attribute identifies the measurement device to execute the service on. The link shall point to the corresponding DeviceSignature for that device. |
| Service | OtxName | - | - | [1] | Identifies the service which shall be executed. The service name shall be defined within the corresponding service declaration within the DeviceSignature. |
| Arguments | DeviceServiceArguments | - | - | [0..1] | The content-type of this simple container element is <xsd:choice> [1..*] which allows an arbitrarylength list of in- and output arguments for the to-be-executed device service's parameters. |
OTL Examples
/// Signatures
package Measure.DeviceSignature DeviceSignature1
{
Measure.DeviceServiceSignature DeviceServiceSignature1(in Integer DeviceServiceInParameter1, out String DeviceServiceOutParameter1);
}
/// Global Declarations
public procedure main()
{
/// Local Declarations
/// Flow
Measure.ExecuteDeviceService(DeviceSignature1, DeviceServiceSignature1, {DeviceServiceInParameter1 = 4, DeviceServiceOutParameter1}, false, false);