IBM FileNet P8, Versión 5.2.1            

Funciones de matriz

Esta sección contiene breves descripciones de las funciones que devuelven información sobre una matriz especificada.

Función Qué hace
arraytostring A partir de los datos de la matriz, el patrón de inicio, el patrón de fin y el separador, devuelve una serie.
elementcount Devuelve el número de elementos no nulos o no vacíos de una matriz.
nextelement A partir de un campo de una matriz y de un índice de esa matriz, devuelve la siguiente entrada no vacía y no nula, o cero si no hay ninguna disponible.

elementcount

Devuelve el número (entero) de elementos no nulos o no vacíos en la matriz. Tenga en cuenta que sizeof (<array_field>) devuelve el tamaño actual de la matriz, pero algunos elementos pueden ser entradas vacías o nulas en la matriz. Para matrices adjuntas, el archivo adjunto vacío se considera vacío.
elementcount(array_field)
donde array_field es el campo de datos que contiene los datos de origen.
Los siguientes son algunos ejemplos:
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100    , , 0) => elementcount(B) = 4; sizeof (B) = 6

Tenga en cuenta que en las matrices de serie no se cuenta una serie vacía, pero en las matrices numéricas se cuentan todos los números. En otras palabras, no hay números vacíos.

Esta función es útil para manejar matrices de participantes y archivos adjuntos.

nextelement

A partir de un campo de matriz y de un índice de la matriz, esta función devuelve la siguiente entrada no vacía y no nula, o cero si no hay ninguna entrada disponible. Si la expresión entera es cero, devuelve el primer elemento no vacío y no nulo.
nextelement(array_field, index_expr)
donde:
Tabla 1. Tabla de parámetros y descripción de la función nextelement
Parámetro Descripción
array_field    El campo de datos que contiene los datos de origen.
index_expr El índice que se debería utilizar para iniciar la búsqueda. Si es cero, iniciará la búsqueda desde el principio de la matriz.
Por ejemplo, utilizando los matrices
A = ("", , "", "alpha",,"")          B =(0 , , 0 , 100    , , 0)

nextelement (A, 0) = 4
nextelement (A, 4) = 0

nextelement (B, 0) = 1
nextelement (B, 1) = 3
nextelement (B, 3) = 4
nextelement (B, 4) = 6
nextelement (B, 6) = 0
Nota: Los índices de matriz de proceso empiezan en uno, pero el índice cero se utiliza para buscar el primer elemento no vacío y no nulo.

Esta función es útil para manejar matrices de participantes y archivos adjuntos.

arraytostring

Esta función convierte datos de matriz en una serie.
arraytostring(array_field, begin_expr, end_expr, separator_expr)
donde:
Tabla 2. Parámetros y descripción de la función arraytostring
Parámetro Descripción
array_field    El campo de datos que contiene los datos de origen.
begin_expr La serie de texto que marca el principio de la matriz.
end_expr La serie de texto que marca el final de la matriz.
separator_expr La serie de texto que se utiliza para separar los elementos en la matriz.
Por ejemplo, a partir del campo de datos MyStringArray con contenido {1,2,3}, se usaría el siguiente mandato para devolver datos de serie:
  • arraytostring(MyStringArray, "{ ", " }", ",") devuelve { 1,2,3 }
Esta función se puede utilizar para devolver una serie a partir de una matriz de campos de datos en un esquema XML de MyXMLField.
arraytostring(MyXMLField, ("<tag><value>", "</value></tag>", "</value><value>")
Ejemplo de esquema


Última actualización: Marzo de 2016
bpfe003.htm

© Copyright IBM Corp. 2016.