Vous pouvez utiliser le mot-clé current avec certaines fonctions de texte pour rendre les formules plus dynamiques, plus pratiques et moins répétitives. Le mot-clé current peut remplacer des paramètres obligatoires dans les fonctions de texte. Les paramètres figés renvoient les mêmes résultats, alors que le mot-clé current peut générer des valeurs dynamiques. Par exemple, si vous utilisez current comme paramètre de page dans une grille constituée de plusieurs pages, il produit la valeur pour chaque page.
Vous pouvez utiliser n'importe quelle forme du mot-clé current : current ou cur. Les mots-clés Current ne respectent pas la casse.
Remarque :
Le mot-clé current est pris en charge dans un objet texte uniquement en cas d'utilisation des fonctions de texte suivantes : MemberName, MemberAlias et MemberDescription, où le mot-clé current spécifie le paramètre de dimension Page. Cependant, le nom de la grille, la ligne et la colonne doivent être définis, si applicable, et ne peuvent pas utiliser le mot-clé current.
Exemple 1 :
Dans la fonction GetCell, de nombreux paramètres peuvent concerner la cellule actuelle dans laquelle la fonction est saisie. Le mot-clé current peut donc être appliqué à cette fonction. La fonction GetCell utilise la syntaxe suivante :
<<GetCell ("GridName", Row, Column, Page)>>
Dans l'exemple suivant, les paramètres figés de la fonction GetCell renvoient la même valeur de cellule pour la page 1, cellule 1A de la grille 1 sur plusieurs pages :
<<GetCell ("Grid1", 1, A, 1)>>
L'exemple suivant utilise le mot-clé current avec la fonction GetCell. La cellule comportant la fonction affiche des valeurs différentes pour chaque page. Remarquez que le mot-clé current est également appliqué au nom de la grille. En cas de modification du nom de la grille, la formule de texte reste correcte.
<<GetCell ("current", 1, current, current)>>
Exemple 2
Lorsque vous utilisez le mot-clé current dans une cellule qui se développe, les résultats sont relatifs à la cellule développée.
L'exemple suivant utilise la fonction GetCell dans une cellule développée (la colonne A se développe en colonnes Trim1, Trim2, Trim3 et la ligne 1 en lignes Est et Ouest). La ligne de texte 1 utilise le mot-clé current pour le paramètre de colonne, alors que la ligne de texte 2 utilise une valeur figée pour le paramètre de colonne.
| Nom | Description |
|---|---|
| . |
Trim1, Trim2, Trim3 |
|
Est, Ouest |
# |
|
Ligne de texte 1 |
|
|
Ligne de texte 2 |
|
Les résultats figurent dans le tableau suivant.
| Nom | Trimestre 1 | Trimestre 2 | Trimestre 3 |
|---|---|---|---|
|
Est |
5 120 |
4 502 |
7 304 |
|
Ouest |
3 405 |
2 300 |
4 462 |
|
Ligne de texte 1 |
5 120 |
4 502 |
7 304 |
|
Ligne de texte 2 |
5 120 |
5 120 |
5 120 |
La ligne de texte 1 utilise le mot-clé current comme paramètre de colonne, ce qui entraîne une mise à jour de la colonne actuelle de chaque cellule développée (Trim1, Trim2, Trim3). De plus, le mot-clé current étant utilisé comme paramètre de page, les valeurs de la ligne de texte 1 actualisent chaque page par rapport à la page actuelle de la grille.
La ligne de texte 2 utilise une valeur figée comme paramètre de colonne (A), ce qui donne la même valeur (5 120) pour tous les trimestres. Une référence figée d'un paramètre de colonne renvoie la même valeur supérieure gauche de la colonne et de la ligne.
Tableau -11 Fonctions de texte prenant en charge le mot-clé Current
| Fonction de texte | Exemple |
|---|---|
<<DataSource("GridName.Axis[ID]",InfoType)>>
Paramètres, si applicables :
|
<<DataSource(current, "App")>> Remarque : Le nom de la grille actuelle est utilisé. |
<<GetCell("GridName",Row,Col,Page)>>
Paramètres, si applicables :
|
<<GetCell(cur, 1, cur, current)>> <<GetCell(cur, 1(3), cur, current)>> Remarque : La valeur de la troisième ligne (développée) de la ligne 1 est indiquée. <<GetCell(cur, cur, A, current)>> <<GetCell(cur, cur, A(B), current)>> Remarque : La valeur de la deuxième colonne (développée) de la colonne A s'afficherait. |
|
Utilisez la fonction ci-dessous dans un en-tête de ligne ou de colonne de données : <<MemberName("DimName")>>
Utilisez la fonction ci-dessous dans un en-tête de ligne ou de colonne autre que de données : <<MemberName("GridName",Row/Col/Page,"DimName")>>
Utilisez le paramètre suivant, le cas échéant :
|
<<MemberName(current)>> <<MemberName("current", Row/Col/Page, "current")>>
Remarque : Renvoie le nom du membre de la ligne, colonne ou page de données qui correspond à la dimension où se trouve la cellule d'en-tête. Elle peut être utilisée avec la fonction |
<<CalcStatus("GridName",Row,Col,Page)>>
Remarque : Les paramètres qui autorisent le mot-clé |
<<CellText("GridName", Row, Column, Page)>>
<<CellText("GridName", Row, Column, Page, MemberOverride)>> |
<<GridDimension("GridName","Axis",index)>>
Remarque : Les paramètres qui autorisent le mot-clé |
<<MemberAlias("DimName")>>
<<MemberAlias("GridName", "DimName")>> <<MemberAlias("GridName", Row|Col|Page, "DimName")>>
<<MemberDesc("DimName")>>
<<MemberDesc("GridName", "DimName")>>
<<MemberDesc("GridName", Row|Col|Page, "DimName")>>
<<MemberName("DimName")>>
<<MemberName("GridName", "DimName")>>
<<MemberName("GridName", Row|Col|Page, "DimName")>>
<<MemberQualifiedName("DimName")>>
<<MemberQualifiedName("GridName", "DimName")>>
<<MemberQualifiedName("GridName", Row|Col|Page, "DimName")>>
<<MemberProperty(DimensionName, Property)>>
<<MemberProperty("GridName", DimensionName, Property)>>
<<MemberProperty("GridName", Row|Col|Page, DimensionName, Property)>> |
<<ProcessManagementStatus("GridName",Row,Column,Page)>>
Remarque : Les paramètres qui autorisent le mot-clé |
|
<<ListOfCellDocuments("GridName",FileName)>>
Remarque : Les paramètres qui autorisent le mot-clé |
|
<<GridDimension("GridName","Axis",Index)>>
Paramètres, si applicables :
|
<<GridDimension(cur,"Page",1)>> <<GridDimension(cur,cur,cur)>> Remarque : Le nom de dimension correspondant à la cellule d'en-tête est affiché. |
<<GetHeading("GridName",Page,Ref,Offset)>>
<<GetHeading("GridName",Page,Ref,"Delim")>>
Paramètres, si applicables :
|
<<GetHeading(cur, cur, A, " - ")>> <<GetHeading(cur, cur, 1, " - ")>> Remarque : Dans les exemples ci-dessus, tous les en-têtes de la colonne A et de la ligne 1 sont affichés pour la page actuelle. <<GetHeading(cur, cur, A, cur)>> Remarque : L'en-tête de la colonne A s'affiche pour la dimension correspondant à l'emplacement de la cellule d'en-tête comportant la formule. <<GetHeading(cur, cur, cur, " - ")>> Remarque : En cas d'utilisation dans une cellule de texte de ligne, le résultat comprend tous les en-têtes de la colonne actuelle séparés par un tiret (-). Cela permet aux utilisateurs de répéter les en-têtes de colonne après un saut de page manuel. |
*L'utilisation du mot-clé current pour le paramètre de référence est limitée. Vous ne pouvez pas utiliser le mot-clé current dans la fonction GetHeading en cas de saisie comme en-tête personnalisé dans une ligne ou une colonne car cela crée une référence circulaire. Vous pouvez utiliser le mot-clé current comme troisième paramètre dans une cellule faisant partie d'une ligne ou d'une colonne de texte ne se trouvant pas dans la zone d'en-tête de la grille. Par exemple, si vous ajoutez la formule <<GetHeading(cur,cur,cur,1)>> dans la cellule A3 et que la ligne 3 est une ligne de texte, le résultat correspond au premier en-tête de la colonne A. Vous pouvez utiliser la fonction GetHeading dans une cellule d'en-tête. Cependant, le paramètre reference ne doit pas utiliser le mot-clé current. Par exemple, lorsque vous entrez <<GetHeading(cur, cur, A, cur)>> dans la cellule d'en-tête de la colonne B, l'en-tête de la colonne A est renvoyé. |
|