O serviço WritePropertyMultiple é utilizado para escrever valores em múltiplas propriedades de múltiplos objetos de um mesmo dispositivo através de uma única mensagem. A execução deste serviço é realizada através de Tags especiais. O Tag WritePropertyMultipleAdd adiciona um valor na lista de escritas pendentes, o Tag WritePropertyMultipleCommand é utilizado para disparar este serviço, o Tag WritePropertyMultiplePending mostra a lista de escritas pendentes e o Tag WritePropertyMultipleResult mostra o resultado da última escrita múltipla.

Este Driver permite armazenar até 20 valores na lista de escritas pendentes. Esta lista é ordenada pelo tipo de objeto, pela instância do objeto e pela propriedade. Após o envio de um serviço de escrita múltipla, os valores cuja escrita foi bem-sucedida são removidos da lista.

Todos os Tags utilizam a Configuração por Strings. O Tag WritePropertyMultipleAdd deve referenciar um dispositivo, objeto e propriedade específicos, podendo também especificar uma prioridade. Os demais Tags devem referenciar somente um dispositivo. Ao fim do parâmetro Item, separado por um espaço, deve ser incluído o texto que identifica o Tag, como no exemplo a seguir:

•ParamDevice: "15:"

•ParamItem: "analogInput-12.presentValue P3 WritePropertyMultipleAdd"

Ou

•ParamDevice: "15:"

•ParamItem: "WritePropertyMultipleCommand"

O Tag WritePropertyMultipleAdd deve ser configurado como um Tag somente de escrita. Este Tag pode ser Simples ou Bloco, dependendo do formato associado à propriedade a ser escrita. Para mais informações, consulte o Apêndice I. Ao escrever um valor neste Tag, o valor é armazenado em uma lista de escritas pendentes. Caso a lista de escritas esteja cheia, o valor é descartado. Caso um novo valor seja escrito antes do envio do valor anterior, o valor anterior é descartado.

O Tag WritePropertyMultipleCommand deve ser configurado como um Tag somente de escrita. Este Tag realiza as seguintes ações, dependendo do valor de escrita recebido:

•Command: Envia o serviço WritePropertyMultiple para executar a escrita dos valores presentes na lista de escritas pendentes

•Clear All: Limpa a lista de escritas pendentes, descartando os valores

•Clear <object type>-<object id>.<property>: Limpa uma entrada específica da lista de escritas pendentes, referente ao objeto de tipo <object type>, instância <object id> e propriedade <property>, descartando este valor

O Tag WritePropertyMultiplePending deve ser configurado como um Tag Bloco somente de leitura. O número de Elementos de Bloco deve ser igual ao dobro do número de valores na lista de escritas pendentes. Cada par de Elementos de Bloco corresponde, sucessivamente, ao identificador de uma propriedade e ao valor da escrita pendente nesta propriedade.

O Tag WritePropertyMultipleResult deve ser configurado como um Tag Bloco somente de leitura com dois Elementos descritos a seguir:

•Elemento 0: Status, um texto informando o resultado da última escrita múltipla. Os valores possíveis são os seguintes:

•Not Executed: Nenhum serviço de escrita múltipla foi enviado ainda

•Success: Todas as escritas do último serviço enviado foram executadas com sucesso

•Failed: Nenhuma escrita do último serviço enviado foi executada com sucesso

•Error(<error class>.<error code>): As escritas do último serviço enviado foram parcialmente executadas com sucesso e interrompidas pelo erro especificado

•Elemento 1: First Failed Write Attempt, um texto identificando a propriedade do último serviço enviado cuja escrita resultou em erro. Todos as propriedades posteriores a esta na lista de escritas pendentes não foram executadas. Este Elemento só é preenchido em caso de erro parcial