Use multiple asset rules to create assets
- Last UpdatedOct 31, 2024
- 3 minute read
There are situations where a single asset rule cannot identify all the streams required to create your assets. In these situations, you must create additional asset rules to accommodate different asset naming patterns.
In the Tank Rule A example, the stream names follow a single pattern that can be defined with one asset rule. Returning to the Tank Rule A example, assume that there is one stream name that deviates from this pattern and cannot be identified by this rule. In the table below, PHI-Tank03-Temp differs from the other stream names and contains a hyphen delimiter between the third and fourth parts of its name, that is, between 03 and Temp.
|
Stream Name |
Asset Name |
Stream Measurement |
|---|---|---|
|
SL-Tank01Press |
Tank 01 |
Pressure |
|
SL-Tank01Temp |
Tank 01 |
Temperature |
|
SL-Tank02Press |
Tank 02 |
Pressure |
|
SL-Tank02Temp |
Tank 02 |
Temperature |
|
PHI-Tank03Press |
Tank 03 |
Pressure |
|
PHI-Tank03-Temp |
Tank 03 |
Temperature |
Therefore, you must create a second asset rule, called Tank Rule B, to identify this stream. The stream name pattern is identical to Tank Rule A, except for the third part of the stream name. In Tank Rule A, this part of the stream name was matched with the next group of numbers option. In Tank Rule B, to correctly identify the PHI-Tank03-Temp stream, 03 must be matched using everything preceding the delimiter "-" option. This token for the third part of the stream name is assigned the name equipment_Id, the same name as in Tank Rule A.
Note: Use the same names for all of the tokens in both rules. This naming pattern makes it easier to manage the rules and troubleshoot any problems that may occur.

Set up the mappings and configure the asset as described in Create an asset rule.
Note: The Id and Name for both rules must resolve to the same values to achieve the intended result, that is one asset that references both streams. If the Ids are different, then two assets with the name Philadelphia 03 are created, one that references the Pressure stream and the other that references the Temperature stream.
Be sure to configure the other asset fields, Description and Metadata the same in both rules.
The following is the asset preview of Tank Rule B which matches the PHI-Tank03-Temp stream for the Philadelphia Tank 03 asset.

Tank Rule A, applied to the streams in this example, creates three tanks with the Philadelphia Tank 03 missing the Temp measurement as shown below.

The two rules complement each other and both are required to create the three assets with stream references for pressure and temperature.