ModifyFlexTag
- Last UpdatedJul 05, 2024
- 2 minute read
This Business Logic Tier (BLT) modifies all flexTag records that match.
Input Parameters
-
paramList (required) - a string with "find" and "modify" parameters.
-
At least one "modify" parameter is required.
-
Entries are separated by asterisks (*).
-
Within each item, the parameter type (F or M), field name, and value are separated by pipes (|).
-
The paramList is of the form: F|findFieldName1|value1*F|findFieldName2| value2*M|modifyFieldName3|value3*M|modifyFieldName4|value4.
-
In the paramList , the "find" items are AND'ed together, so that all fields must match.
-
There is one exception to this rule - if DBnPnt items are specified, they are OR'ed together.
-
DBnPnt values are of the form "point/database". This feature supports Tag Grouping.
Results
The first result set contains the matching tags that were successfully modified. The second result set contains the matching tags that did not get modified (including those not within your Area of Responsibility (AOR)).
Examples
In each case, these are the flexTags defined before the ModifyFlexTag BLT is called (we assume they are reset to these values):
Initial
|
Database |
Point |
tagType |
workOrder |
Description |
|---|---|---|---|---|
|
analog |
ana1 |
InfoLow |
|
|
|
analog |
ana2 |
WarningHigh |
|
|
|
status |
sta1 |
InhCrit |
|
|
|
status |
sta2 |
InfoLow |
|
|
|
multistate |
mul1 |
InhCrit |
|
|
|
multistate |
mul1 |
InfoLow |
|
|
|
multistate |
mul2 |
WarningHigh |
|
|
Records after ModifyFlexTag are called with paramList = M|workOrder|myWO * M| description|new description:
|
Database |
Point |
tagType |
workOrder |
Description |
|---|---|---|---|---|
|
analog |
ana1 |
InfoLow |
myWO |
new description |
|
analog |
ana2 |
WarningHigh |
myWO |
new description |
|
status |
sta1 |
InhCrit |
myWO |
new description |
|
status |
sta2 |
InfoLow |
myWO |
new description |
|
multistate |
mul1 |
InhCrit |
myWO |
new description |
|
multistate |
mul1 |
InfoLow |
myWO |
new description |
|
multistate |
mul2 |
WarningHigh |
myWO |
new description |
Records after ModifyFlexTag are called with paramList = F|database|analog * M|description|analog tags:
|
Database |
Point |
tagType |
workOrder |
Description |
|---|---|---|---|---|
|
analog |
ana1 |
InfoLow |
|
analog tags |
|
analog |
ana2 |
WarningHigh |
|
analog tags |
|
status |
sta1 |
InhCrit |
|
|
|
status |
sta2 |
InfoLow |
|
|
|
multistate |
mul1 |
InhCrit |
|
|
|
multistate |
mul1 |
InfoLow |
|
|
|
multistate |
mul2 |
WarningHigh |
|
|
Records after ModifyFlexTag are called with paramList = F|curTagType|InfoLow *M|curTagType|WarningCrit:
|
D=database |
Point |
tagType |
workOrder |
Description |
|---|---|---|---|---|
|
analog |
ana1 |
WarningCrit |
|
|
|
analog |
ana2 |
WarningHigh |
|
|
|
status |
sta1 |
InhCrit |
|
|
|
status |
sta2 |
WarningCrit |
|
|
|
multistate |
mul1 |
InhCrit |
|
|
|
multistate |
mul1 |
WarningCrit |
|
|
|
multistate |
mul2 |
WarningHigh |
|
|
Records after ModifyFlexTag are called with paramList = F|DBnPnt|ana2/analog*F| DBnPnt|sta2/status*F|DBnPnt|mul2/multistate*M|description|subset:
|
Database |
Point |
tagType |
workOrder |
Description |
|---|---|---|---|---|
|
analog |
ana1 |
InfoLow |
|
|
|
analog |
ana2 |
WarningHigh |
|
subset |
|
status |
sta1 |
InhCrit |
|
|
|
status |
sta2 |
InfoLow |
|
subset |
|
multistate |
mul1 |
InhCrit |
|
|
|
multistate |
mul1 |
InfoLow |
|
|
|
multistate |
mul2 |
WarningHigh |
|
subset |