ReadRange

<< Clique para Mostrar o Sumário >>

 

ReadRange

O serviço ReadRange é utilizado para realizar a leitura de um intervalo dos dados de uma propriedade do tipo Lista. A execução deste serviço é realizada através de dois Tags. O Tag ReadRangeCommand é utilizado para disparar este serviço e o Tag ReadRangeResult recebe o resultado desta operação.

Ambos os Tags utilizam a Configuração por Strings para referenciar um dispositivo, objeto e propriedade específicos. A propriedade deve ser do tipo Lista. 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: "trendLog-10.logBuffer ReadRangeCommand"

 

O Tag ReadRangeCommand deve ser configurado como um Tag Simples somente de escrita. Para iniciar este serviço, este Tag deve receber a escrita de um array com 3 (três) Elementos, no seguinte formato:

Elemento 0: Type, um texto identificando o tipo de intervalo a ser lido. Os valores válidos são FullRange, Position, SequenceNumber ou Time

Elemento 1: Reference, uma referência para o Elemento inicial ou final. Se o tipo do intervalo é igual a Position ou SequenceNumber, deve ser um inteiro sem sinal. Se o tipo do intervalo é igual a Time, deve ser uma data e hora

Elemento 2: Count, um inteiro informando o número de Elementos a serem lidos. Para valores positivos, a referência é o início do intervalo. Para valores negativos, a referência é o fim do intervalo

 

O Tag ReadRangeResult deve ser configurada como um Tag Bloco somente de leitura com 6 (seis) Elementos. Os Elementos e os tipos de dados são os seguintes:

Elemento 0: First Item, um valor booleano

Elemento 1: Last Item, um valor booleano

Elemento 2: More Items, um valor booleano

Elemento 3: Item Count, um inteiro sem sinal

Elemento 4: Item Data, um texto no formato XML

Elemento 5: First Sequence Number, um inteiro sem sinal, presente apenas em intervalos de tipo SequenceNumber e Time

Esta página foi útil?