Technical information

Programming - Asset Management
84
RMS Enterprise - NetLinx Programmer’s Guide
Synchronizing Asset Metadata Properties
The following callback method will be invoked in each asset monitoring module when it is time to perform the Asset metadata
synchronization with RMS.
(***********************************************************)
(* Name: SynchronizeAssetMetadata *)
(* Args: -none- *)
(* *)
(* Desc: This is a callback method that is invoked by *)
(* RMS to notify this module that it is time to *)
(* update/synchronize this asset metadata properties*)
(* with RMS if needed. *)
(* *)
(* This method should not be invoked/called *)
(* by any user implementation code. *)
(***********************************************************)
DEFINE_FUNCTION SynchronizeAssetMetadata ()
{
}
Traditionally, asset metadata properties are relatively static information and thus do not require any synchronization of values after
registration. However, this callback method does provide the opportunity to perform any necessary metadata updates if your
implementation does include any dynamic metadata property values.
The RmsApi.axi Include File (which is already included by each asset monitoring module) provides the following wrapper function
for updating asset metadata property values with RMS.
RmsAssetMetadataUpdateString (see page 85)
RmsAssetMetadataUpdateBoolean (see page 86)
RmsAssetMetadataUpdateNumber (see page 87)
RmsAssetMetadataUpdateDecimal (see page 88)
RmsAssetMetadataUpdateHyperlink (see page 89)
RmsAssetMetadataUpdateValue (see page 90)
The following code snippet provides an example of updating asset metadata properties.
// this is a new asset registration, register all
RmsAssetMetadataUpdateNumber(assetClientKey,
'touch.panel.display.timeout',
panelInfo.displayTimeout);
RmsAssetMetadataUpdateNumber(assetClientKey,
'touch.panel.shutdown.timeout',
panelInfo.shutdownTimeout);
RmsAssetMetadataUpdateString(assetClientKey,
'touch.panel.file.system',
panelInfo.fileSystem);