Technical information

Programming - Asset Management
75
RMS Enterprise - NetLinx Programmer’s Guide
The following code snippet provides an example of queuing asset parameter value updates and sending them in a final submit call.
// battery level
RmsAssetParameterEnqueueSetValueLevel(assetClientKey,
'touch.panel.battery.level',
panelInfo.batteryLevel);
// battery charging
RmsAssetParameterEnqueueSetValueBoolean(assetClientKey,
'touch.panel.battery.charging',
panelInfo.charging);
// submit all the pending parameter updates now
RmsAssetParameterUpdatesSubmit(assetClientKey);
Registering Asset Metadata Properties
The following callback method will be invoked in each asset monitoring module when it is time to perform the Asset metadata
registration with RMS.
(***********************************************************)
(* Name: RegisterAssetMetadata *)
(* Args: -none- *)
(* *)
(* Desc: This is a callback method that is invoked by *)
(* RMS to notify this module that it is time to *)
(* register this asset's metadata properties with *)
(* RMS. *)
(* *)
(* This method should not be invoked/called *)
(* by any user implementation code. *)
(***********************************************************)
DEFINE_FUNCTION RegisterAssetMetadata()
{
}
The RmsApi.axi Include File (which is already included by each asset monitoring module) provides the following wrapper function
for registering asset metadata properties with RMS.
RmsAssetMetadataEnqueueString (see page 77)
RmsAssetMetadataEnqueueBoolean (see page 78)
RmsAssetMetadataEnqueueNumber (see page 79)
RmsAssetMetadataEnqueueDecimal (see page 80)
RmsAssetMetadataEnqueueHyperlink (see page 81)
RmsAssetMetadataEnqueue (see page 82)
RmsAssetMetadataSubmit (see page 83)
Each asset parameter metadata property requires the following information:
Asset Metadata Properties - Required Information
Key (String) This is a unique identifier for this asset metadata property.
This ID string must be uniquely scoped for this asset. Metadata property value updates will use this key
identifier when operating on this metadata property.
Name (String) Friendly name for this asset metadata property.
Value (String) Value field for this asset metadata property.
This is required for all metadata property types except HYPERLINK.