Especifique o valor de um elemento em um campo indexado

Conjuntos de dados e parâmetros › Parâmetros do processo › Parâmetros calculados › Acessar os campos do conjunto de dados em expressões › Especifique o valor de um elemento em um campo indexado

Especifique o valor de um elemento em um campo indexado

Para acessar um valor em um campo indexado (array), use a seguinte sintaxe:

dataset_reference.indexed_field_name[index]

O parâmetro indexed_field_name define o nome do campo no conjunto de dados. Index é um número inteiro que especifica um elemento indexado na matriz.

Para especificar a sequência de caracteres indexed_field_name com a notação de colchetes, use a sintaxe a seguir. No exemplo, indexed_field_name_expression é uma expressão do CA Process Automation que retorna a sequência de caracteres indexed_field_name.

dataset_reference[indexed_field_name_expression][index]

Como as matrizes do JavaScript, os campos indexados do CA Process Automation são matrizes de matrizes em vez de matrizes verdadeiras. Para acessar um elemento em uma matriz de matrizes, use o operador [ ] duas vezes. Por exemplo, para os números inteiros chamados pelo campo de número inteiro indexado bidimensional, cada número inteiro[x] do elemento de lista é uma lista indexada de números inteiros. Para acessar um determinado número inteiro no campo indexado, é possível gravar os números inteiros[x][y] da expressão. Em geral, para qualquer campo indexado de n-dimensões, use a seguinte sintaxe para acessar qualquer elemento de dados:

dataset_reference.indexed_field_name[index1][index2] ... [indexn]

O parâmetro index é um número inteiro ou uma expressão que retorna um número inteiro. O parâmetro tem um valor de 0 (para o primeiro valor em uma lista indexada) até o comprimento da lista menos 1. A avaliação do índice é circular, portanto quando o valor de index exceder o comprimento de uma lista indexada, a seguinte fórmula determinará o seu valor:

Actual-index = index % length-of-the-list;

Em outras palavras, para n elementos em um campo indexado, você obtém os seguintes resultados:

Um índice de n retorna o elemento 0
Um índice de n+ 1 retorna o elemento 1
Um índice de n-1 retorna o último elemento

A seguinte tabela exibe os resultados do acesso de elementos de um campo indexado em um conjunto de dados do processo:

Expressão	Descrição
value = Process.X[2]	Refere-se ao terceiro elemento de um campo indexado X do conjunto de dados do processo.
value = Process.X[18]	Para um campo X indexado com um tamanho de 19, essa expressão se refere ao elemento 19 de X, o mesmo que Process.X[18].
value = Process.X[Process.Y + 2]	Uma expressão que calcula o índice.
value = Process.A[5][2]	Retorna o valor em uma matriz bidimensional. O terceiro elemento na sexta lista indexada que a matriz define resolve a matriz.