Difference between revisions of "Extensions.Logging.WriteLog"
Jump to navigation
Jump to search
| (2 intermediate revisions by one other user not shown) | |||
| Line 5: | Line 5: | ||
== OTL Syntax == | == OTL Syntax == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| − | Logging.WriteLog(SeverityLevelTerm, StringTerm, StringTerm); | + | Logging.WriteLog(SeverityLevelTerm level, StringTerm target, StringTerm message); |
</syntaxhighlight> | </syntaxhighlight> | ||
== Description == | == Description == | ||
| − | The '''WriteLog''' activity | + | The '''WriteLog''' activity will cause the OTX runtime system to write a log-message into a logging-resource provided that the severity-level of that message is higher or equal than the currently set log-level threshold. The particular logging-resource to which the log-message will be written may be identified by the optional '''<target>''' element. Otherwise (if no explicit target is given), the location of the logging-resource depends on the specific runtime system settings. See [[Extensions.Logging|Logging]]. |
== Properties == | == Properties == | ||
| Line 15: | Line 15: | ||
{{TableRowPropertiesHeader}} | {{TableRowPropertiesHeader}} | ||
{{TableRowPropertie2| Level | [[Extensions.Logging.SeverityLevel|SeverityLevel]] | [[Term]] | - | [1] | This element represents the severity-level of the log-message, see [[Extensions.Logging|Logging]].}} | {{TableRowPropertie2| Level | [[Extensions.Logging.SeverityLevel|SeverityLevel]] | [[Term]] | - | [1] | This element represents the severity-level of the log-message, see [[Extensions.Logging|Logging]].}} | ||
| − | {{TableRowPropertie1| Target | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [0..1] | The optional element | + | {{TableRowPropertie1| Target | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [0..1] | The optional element will be used for locating the resource to which the message will be written. The target will be defined by a URI}} |
{{TableRowPropertie2| Message | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [1] | This string value represents the log-message}} | {{TableRowPropertie2| Message | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [1] | This string value represents the log-message}} | ||
|} | |} | ||
| Line 21: | Line 21: | ||
== OTL Examples == | == OTL Examples == | ||
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | <syntaxhighlight lang="java" enclose="div" style="font-size: medium;"> | ||
| + | /// Local Declarations | ||
| + | |||
| + | /// Flow | ||
| + | |||
Logging.WriteLog(@SeverityLevel:TRACE, NULL, "Message"); | Logging.WriteLog(@SeverityLevel:TRACE, NULL, "Message"); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Latest revision as of 02:45, 13 September 2019
Classification
| Name | WriteLog |
| Short Description | Writing a log message |
| Class | Action |
| Extension | OTX Logging extension |
| Group | Logging related actions |
| Exceptions | InvalidReferenceException |
| Checker Rules | - |
| Standard Compliant | Yes |
OTL Syntax
Logging.WriteLog(SeverityLevelTerm level, StringTerm target, StringTerm message);Description
The WriteLog activity will cause the OTX runtime system to write a log-message into a logging-resource provided that the severity-level of that message is higher or equal than the currently set log-level threshold. The particular logging-resource to which the log-message will be written may be identified by the optional <target> element. Otherwise (if no explicit target is given), the location of the logging-resource depends on the specific runtime system settings. See Logging.
Properties
| Name | Data Type | Class | Default | Cardinality | Description |
| Level | SeverityLevel | Term | - | [1] | This element represents the severity-level of the log-message, see Logging. |
| Target | String | Term | - | [0..1] | The optional element will be used for locating the resource to which the message will be written. The target will be defined by a URI |
| Message | String | Term | - | [1] | This string value represents the log-message |
OTL Examples
/// Local Declarations
/// Flow
Logging.WriteLog(@SeverityLevel:TRACE, NULL, "Message");