- Solution Name: Tags Parse
- Software Version: v10
- Keywords: Tags. Parse. Scripts. ScriptClass. Expressions. EventHandling.
Summary
This example demonstrates how to parse Tags using three distinct methods.
Technical Information
There are various methods to address challenges when parsing Tags. This example showcases three approaches: simple script-based parsing, expression-driven tag changes, and event-driven parsing. Depending on the complexity of the task and required flexibility, these methods can be employed as solutions.
Method 1: Parsing Tags via Client Script
In this method, the button in the purple box is linked to a script called ParseTags_Client
. When pressed, it invokes the ParseTags_Client
method, which calls the asynchronous Main
method, passing the name of the tag obtained from @Tag.TagTestClient.GetName()
as a parameter. The Main
method updates MessageClassClient
with the text "TagName: " followed by the actual tag name, which is displayed in a message box. It also traces the tag name for logging purposes. The aforementioned code is seen below:
public async Task ParseTags_Client(object sender, System.Windows.Input.InputEventArgs e) { @Script.Class.ParseTags_Client.Main(@Tag.TagTestClient.GetName()); // Sends the desired tag to the function, receives a response string TagName: <tag name> }
Method 2: Using Expressions and ScriptClass
In this method, the button in the blue box triggers a tag's value to change, this tag is configured as a trigger to the expression Script.Class.ParseTags.ParseTagServer(Tag.TagTestServer.GetName())
. This expression calls the ParseTagServer
method from the ParseTags
script, passing the name of the tag obtained from Tag.TagTestServer.GetName()
as a parameter. The ParseTagServer
method traces the tag name for logging purposes and updates the MessageExpressions
with "TagName: " followed by the actual tag name, which is displayed in a message box when triggered.
Method 3: Complex Parsing with Event Handling
The third example demonstrates a more complex setup. Upon solution initialization, the Initialize
method from the ParseTags
ScriptClass is called. This method initializes a list and feeds two Tags into it. When the values of these tags change, an event is triggered, displaying the updated tag value in a message box. The ObjectReferenceHandler
method logs the tag’s name and value when the event is triggered. To illustrate this, a button was included. When pressed, it changes the tagTestServer's value, causing this event to be registered and the new value to be displayed in the message box.
Reference Information
→ See Unified Namespaces Enumerations for more information.
In this section: