CasewareDocumentation
Nouveautés de Caseware Cloud EngagementsVoir les nouveautés

Fonction CUSTPROP

La fonction CUSTPROP renvoie la propriété personnalisée spécifiée par « name ». L'argument « scope » est facultatif ; il sert à déterminer le niveau de recherche. Par exemple, pour un objet ligne de tableau, l'utilisateur peut choisir de récupérer la propriété personnalisée à partir de la ligne de tableau ou à partir du tableau.

Syntaxe

CUSTPROP("nom", <"portée">)

Où

Nom indique le libellé de la propriété personnalisée à renvoyer.

Remarque: Cette valeur tient compte de la casse, ce qui permet l'existence simultanée des propriétés personnalisées AAA et aaa.

Portée peut prendre l'une des valeurs suivantes :

  • C - Cellule

  • P - Paragraphe

  • T - Table

  • TR - Ligne

  • TC - Chronique

  • D - Paramètres du document

  • SSK - Il s'agit de la plus petite section comportant un lien vers la bibliothèque de connaissances qui englobe l'objet contenant le calcul (le plus simple est de l'imaginer comme un paragraphe).

  • SSL - Il s'agit de la plus petite section comportant une étiquette qui englobe l'objet contenant le calcul.

Remarques

  • Si aucun type de paramètre n'est spécifié, la fonction CUSTPROP() recherchera et utilisera les propriétés des éléments suivants, dans l'ordre :
    1. Cellule
    2. Paragraphe
    3. Colonne du tableau
    4. Ligne du tableau
    5. Tableau
    6. Document

Exemple

CUSTPROP("Propriété 1", <"portée">)

La liste ci-dessous présente les cas (pour « scope »)

Paragraphe :

  1. Manquant ou « P » ==> récupérer la propriété personnalisée du paragraphe
  2. « TR » ==> récupère la propriété personnalisée spécifiée de la ligne du tableau dans laquelle se trouve ce paragraphe, si ce paragraphe figure dans un tableau
  3. « TC » ==> récupère la propriété personnalisée du nom de la colonne du tableau dans lequel se trouve ce paragraphe, si ce paragraphe figure dans un tableau
  4. « T » permet d'obtenir la propriété personnalisée spécifiée du tableau dans lequel se trouve ce paragraphe, si ce paragraphe figure dans un tableau
  5. « D » permet d'obtenir la propriété personnalisée spécifiée dans les paramètres du document.

Ligne du tableau :

  1. Manquant ou « TR » ==> récupérer la propriété personnalisée indiquée de la ligne du tableau
  2. « T » ==> récupérer la propriété personnalisée du nom indiqué dans la table

Colonne du tableau :

  1. Manquant ou « TC » ==> récupérer la propriété personnalisée du nom de la colonne du tableau
  2. « T » ==> récupérer la propriété personnalisée du nom indiqué dans la table

Remarques

  • Une chaîne vide est renvoyée si la fonction ne trouve aucune correspondance.
  • Le paramètre « name » peut être un calcul si la propriété personnalisée récupérée est une propriété de type texte. Si la propriété personnalisée source est une propriété calculée, CUSTPROP ne peut déterminer sa valeur correcte que si le paramètre « name » est une chaîne de caractères constante.

Sujets connexes