IBM FileNet P8, Version 5.2.1            

Fonctions de tableau

Cette section contient de brèves descriptions des fonctions qui renvoient des informations sur un tableau spécifique.

Fonction Action
arraytostring Renvoie une chaîne sur la base de données de tableau fournies, d'un modèle de départ, d'un modèle de fin et d'un séparateur.
elementcount Renvoie le nombre d'éléments non nuls ou non vides présents dans un tableau.
nextelement Renvoie l'entrée suivante non vide et non nulle, ou zéro s'il n'en existe pas, sur la base d'une zone de tableau et d'un index fournis.

elementcount

Renvoie le nombre (entier) d'éléments non nuls ou non vides contenus dans le tableau. Notez que la fonction sizeof (<array_field>) renvoie la taille actuelle du tableau mais que certains éléments peuvent être des entrées nulles ou vides dans le tableau. Pour les tableaux de pièces jointes, une pièce jointe vide est considérée comme une entrée vide.
elementcount(array_field)
où array_field représente la zone de données qui contient les données source.
Exemples :
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100    , , 0) => elementcount(B) = 4; sizeof (B) = 6

Notez qu'une chaîne vide n'est pas comptée dans les tableaux de chaînes alors que chaque nombre est compté dans les tableaux numériques. Autrement dit, les nombres vides n'existent pas.

Cette fonction permet de gérer les tableaux de pièces jointes et de participants.

nextelement

La fonction renvoie l'entrée suivante non vide et non nulle, ou zéro s'il n'en existe pas, sur la base d'une zone de tableau et d'un index fournis. Si l'expression de type nombre entier est égale à zéro, elle renvoie le premier élément non vide non nul.
nextelement(array_field, index_expr)
où :
Tableau 1. Tableau des paramètres et de leur description pour la fonction nextelement
Paramètre Description
array_field    Représente la zone de données qui contient les données source.
index_expr Index à utiliser pour démarrer la recherche. Si l'index est égal à zéro, la recherche commence au début du tableau.
Par exemple, avec les tableaux suivants :
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
Remarque : Les index de tableau Process commencent à un mais l'index zéro est utilisé pour rechercher le premier élément non vide et non nul.

Cette fonction permet de gérer les tableaux de pièces jointes et de participants.

arraytostring

Cette fonction convertit des données de tableau en une chaîne.
arraytostring(array_field, begin_expr, end_expr, separator_expr)
où :
Tableau 2. Paramètres et description de la fonction arraytostring
Paramètre Description
array_field    Représente la zone de données qui contient les données source.
begin_expr Chaîne texte qui marque le début du tableau
end_expr Chaîne texte qui marque la fin du tableau
separator_expr Chaîne texte utilisée pour séparer les éléments dans le tableau
Par exemple, pour la zone de données MyStringArray contenant {1,2,3}, vous pouvez entrer la commande suivante pour renvoyer des données de chaîne :
  • arraytostring(MyStringArray, "{ ", " }", ",") renvoie { 1,2,3 }
Vous pouvez utiliser cette fonction pour renvoyer une chaîne à partir d'un tableau de zone de données dans un schéma XML dans MyXMLField.
arraytostring(MyXMLField, ("<tag><value>", "</value></tag>", "</value><value>")
Exemple de schéma


Dernière mise à jour : Octobre 2015
bpfe003.htm

© Copyright IBM Corp. 2015.