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

Acessar o comprimento de um campo indexado

O CA Process Automation oferece suporte à propriedade de comprimento do JavaScript para matrizes e sua própria propriedade de tamanho para acessar o comprimento de um campo indexado. A propriedade de comprimento é somente leitura; a propriedade de tamanho permite alterar o número de elementos em um campo indexado. A propriedade de comprimento usa a notação de ponto ou de colchetes para retornar o número de elementos em um campo indexado:

dataset_reference.indexed_field_name.length

dataset_reference[indexed_field_name_expression].length

A propriedade de tamanho funciona da mesma maneira, usando a observação ponto ou colchetes:

dataset_reference.indexed_field_name.size

dataset_reference[indexed_field_name_expression].size

Como um campo indexado é uma matriz com base zero, as propriedades de tamanho e comprimento sempre retornam um a mais que o índice para o último elemento em um campo. Assim, quando um comprimento ou tamanho retornar n, um campo conterá 0, 1,..., n-1 elementos indexados e o índice do último elemento na matriz será n-1.

Atribuir um novo valor para a propriedade de tamanho aumenta ou trunca o número de elementos em um campo indexado. Diminuir o valor da propriedade de tamanho remove os elementos da extremidade superior de um campo indexado e exclui valores armazenados nos elementos excluídos. O seguinte código usa a propriedade de tamanho para aumentar o comprimento de uma matriz X por um elemento e, em seguida, atribui 25 ao novo elemento:

Process.X.size = Process.X.size + 1;
Process.X[Process.X.size - 1] = 25;

Para uma matriz multidimensional, a propriedade de tamanho ou comprimento retorna o número de elementos em um endereço de matriz ao qual ela está anexada.

Por exemplo, para uma matriz bidimensional chamada matriz [a][b], a seguinte sintaxe retorna o tamanho da primeira dimensão de matriz, com os elementos contendo 0... size1-1:

size1 = matrix.length

A seguinte sintaxe retorna o tamanho da segunda dimensão de matriz, fornecendo primeiro o elemento 2 da dimensão, com b contendo os elementos 0... size2-1 quando a = 2. contendo os elementos 0... size1-1:

size2 = matrix[2].length

O exemplo a seguir ilustra como endereçar elementos de um campo indexado multidimensional por um loop através de todos os elementos em um campo indexado bidimensional (uma matriz de matrizes) na variável do conjunto de dados do processo chamada matrix. O código atribui o valor de cada elemento de um campo indexado unidimensional na variável do conjunto de dados do processo chamada values:

var i; j; k=0;
para (i=0; i < Process.matrix.length; i++)
{

para (j=0; j < Process.matrix[i].length; j++)

{

Process.values[k] = Process.matrix[i][j]
	k++

}

}