Manuel de l'utilisateur › Rapports › Types de rapports › Présentation des livrets › Création d'un livret › Création des livrets au format .docx › Balises de livret et d'exportation de contrat › Livrets paramétrés › Syntaxe des paramètres de livret

Syntaxe des paramètres de livret

La syntaxe d'un modèle de livret est similaire à celle de la transmission de paramètres aux rapports au format libre.

Commentaires sur la syntaxe :

• Le nom du paramètre provient d'une liste prédéfinie de noms saisis en majuscules. Il ne s'agit pas d'un champ de texte libre (seuls les paramètres au format libre sont en texte libre).
• La valeur du paramètre est de type texte libre ou valeur contextuelle. En l'absence de contexte de contrat, les valeurs contextuelles ne sont pas transmises.
• La valeur est sensible à la casse.
• Lors de la transmission de plusieurs valeurs pour un même paramètre pour lequel la sélection multiple n'a pas été définie ou lors d'une transmission à plusieurs reprises d'un même paramètre, la dernière valeur apparaissant dans le modèle est transmise.
• Si aucune valeur n'est transmise (absence de mot clé VALUE ou de <<VALUE=>>), le livret transmet la valeur null. La valeur de filtre initiale est ainsi supprimée, comme si elle ne figurait pas dans le rapport favori (similaire à All).
• La transmission d'un nom de paramètre qui n'existe pas n'a aucun effet.

Les valeurs de paramètre sont fusionnées avec le filtre favori initial lorsque les paramètres du livret sont prioritaires par rapport au filtre initial. De cette manière, si vous transmettez un paramètre à un filtre qui existe déjà dans le rapport, le filtre utilise le paramètre du livret.

• Si vous définissez des caractères de sélection multiple ou génériques, déclarez-les à l'aide du mot clé SELECT_TYPE. Valeurs possibles: MULTI, WILDCARD ou SINGLE (multiple, caractère générique ou unique).
• Si vous avez défini la sélection multiple des ressources ou des groupes de ressources, vous pouvez sélectionner uniquement un type. Vous devez déclarer celui que vous avez utilisé dans le paramètre à l'aide du mot clé IS_GROUP. Valeur possible : YES ou NO.
• Lorsque vous définissez une sélection multiple, vous devez indiquer le chemin complet de l'entité en séparant les dossiers au moyen d'une barre oblique "/". Lorsque vous sélectionnez plusieurs métriques, vous pouvez choisir de ne pas définir le chemin complet. Le contexte de contrat est alors utilisé pour obtenir les informations pertinentes.
• Les favoris composés et de groupe ont la même syntaxe que le paramètre Normal. Pour les rapports composés, les valeurs des paramètres sont transmises à chaque série. Pour les groupes de rapports, une valeur est transmise à chaque membre du groupe (rapports au format libre également). Si le groupe contient des rapports composés, les valeurs des paramètres sont transmises à chaque série de chaque membre.

Exemple de syntaxe des paramètres de livret

<<BEGIN_FAVORITE=Normal favorite name>>

<<BEGIN_PARAMETER>>
<<NAME=AGGREGATION>><<VALUE=Sum>>
<<END_PARAMETER>>

<<BEGIN_PARAMETER>>
<<NAME=CONTRACT>><<CONTEXT_VALUE=SLA_NAME>>
<<END_PARAMETER>>

<<BEGIN_PARAMETER>>
<<NAME=SERVICE>><<VALUE=Service 1>>
<<END_PARAMETER>>

<<BEGIN_PARAMETER>>
<<NAME=RESOURCE>><<IS_GROUP=NO>><<VALUE=Resource 1>>
<<END_PARAMETER>>

<<BEGIN_PARAMETER>>
<<NAME=metric >>
<<SELECT_TYPE=MULTI>>
<<VALUE=Contract Party/Contract/metric 1>>
<<VALUE=Contract Party/Contract/metric 2>>
<<VALUE=Contract Party/Contract/metric 3>>
<<END_PARAMETER>>

<<NAME>>
<<CHART>>
<<DATA>>
<< END_FAVORITE>>