AMX RMS Informations techniques télécharger pdf (Page 105)

Programming - Asset Management

RMS Enterprise - NetLinx Programmer’s Guide

Asset Metadata Update Functions (Cont.)

RmsAssetMetadata

UpdateNumber

Description: This function is used to update and existing asset metadata property value.

This function updates a metadata property of type: NUMBER

Arguments:

• CHAR assetClientKey[] - asset client key

• CHAR metadataKey[] - metadata property key

• SLONG metadataValue - metadata property value

Returns: 1 if call was successful; 0 if call was unsuccessful

Syntax:

DEFINE_FUNCTION CHAR RmsAssetMetadataUpdateNumber(CHAR assetClientKey[],

CHAR metadataKey[],

SLONG metadataValue)

{

STACK_VAR CHAR rmsCommand[RMS_MAX_CMD_LEN];

// ensure RMS is ONLINE, REGISTERED, and ready for ASSET registration

IF(![vdvRMS,RMS_CHANNEL_ASSETS_REGISTER])

{

SEND_STRING 0, '>>>> RMS API ERROR <RmsAssetMetadataUpdateNumber> :: RMS is not ready to accept asset

metadata changes.';

RETURN FALSE;

}

// ensure an asset client key has been provided

IF(assetClientKey == '')

{

SEND_STRING 0, '>>>> RMS API ERROR <RmsAssetMetadataUpdateNumber> :: missing asset client key';

RETURN FALSE;

}

// ensure a metadata key has been provided

IF(metadataKey == '')

{

SEND_STRING 0, '>>>> RMS API ERROR <RmsAssetMetadataUpdateNumber> :: missing metadata key';

RETURN FALSE;

}

// submit the asset metadata update now

RETURN RmsAssetMetadataUpdateValue(assetClientKey,metadataKey,

ITOA (metadataValue

));

}

1 2 ... 100 101 102 103 104 105 106 107 108 109 110 ... 219 220

Pas de commentaire

AMX RMS Informations techniques Page 105