Cómo especificar el valor de un elemento en un campo indexado

Conjuntos de datos y parámetros › Parámetros del proceso › Parámetros calculados › Acceso a los campos del conjunto de datos en las expresiones › Cómo especificar el valor de un elemento en un campo indexado

Cómo especificar el valor de un elemento en un campo indexado

Para acceder a un valor en un campo indexado (matriz), utilice la sintaxis siguiente:

dataset_reference.indexed_field_name[index]

El parámetro indexed_field_name especifica el nombre de campo en el conjunto de datos. Index es un entero que se remite a un elemento indexado de la matriz.

Para especificar la cadena indexed_field_name con la notación de corchetes, utilice la sintaxis siguiente. En el ejemplo, indexed_field_name_expression es una expresión de CA Process Automation que devuelve la cadena indexed_field_name.

dataset_reference[indexed_field_name_expression][index]

Al igual que las matrices de JavaScript, los campos indexados de CA Process Automation son "matrices de matrices", en lugar de verdaderas matrices. Para acceder a un elemento en una matriz de matrices, utilice el operador [ ] dos veces. Por ejemplo, para el campo de entero indexado bidimensional llamado "integers", todos los elementos de lista integers[x] son, en sí mismos, una lista indexada de enteros. Para acceder a un entero concreto del campo indexado, debe escribir la expresión integers[x][y]. En general, para cualquier campo indexado de n dimensiones, utilice la sintaxis siguiente para acceder a cualquier elemento de datos:

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

El parámetro index es un entero o una expresión que devuelve un entero. El parámetro tiene un valor desde 0 (para el primer valor en una lista indexada) hasta la longitud de la lista menos 1. La evaluación del index es circular, por tanto, cuando el valor de index supera la longitud de una lista indexada, se utiliza la fórmula siguiente para determinar su valor:

Índice-real = índice % longitud-de-la-lista;

Dicho de otra manera, para n elementos en un campo indexado, se obtienen los resultados siguientes:

Un índice n devuelve el elemento 0
Un índice n+1 devuelve el elemento 1
Un índice n-1 devuelve el último elemento

La tabla siguiente ilustra los resultados de los elementos de acceso de un campo indexado en un conjunto de datos del proceso:

Expresión	Descripción
valor = Process.X[2]	Se refiere al tercer elemento de un campo indexado X del conjunto de datos del proceso.
valor = Process.X[18]	Para un campo indexado X con un tamaño de 19, esta expresión hace referencia al elemento 19 de X, el mismo que Process.X[18].
valor = Process.X[Process.Y + 2]	Una expresión calcula el índice.
valor = Process.A[5][2]	Devuelve el valor en una matriz bidimensional. El tercer elemento en la sexta lista indexada definida por la matriz define la matriz.