Définition des attributs

Nom

Type d'attribut :

• Date

• Date et heure

• Entier

• Liste :

  Si vous sélectionnez Liste, entrez une liste de réponses valides pour la question.

• Texte multi-ligne

  La longueur maximale doit être inférieure à 4 000 caractères.

  Sélectionnez Texte multi-ligne, puis saisissez le nombre de lignes, de 3 à 50 lignes. Texte multi-lignes détermine le nombre de lignes de texte visibles, sans défilement, sur les boîtes de dialogue Actions.

  Pour le type Texte multi-lignes : sélectionnez Inclure des pièces jointes si vous souhaitez que l'attribut personnalisé inclue une section Pièces jointes dans la boîte de dialogue Actions.

• Nombre :

  Si vous choisissez Nombre, sélectionnez les options de format de nombre comme suit :

  • Pour Nombre de décimales, entrez une valeur pour le nombre de décimales à afficher.

  • Sélectionnez l'option Séparateur des milliers si vous souhaitez que les nombres apparaissent avec un séparateur des milliers (par exemple, 1 000,00)

  • Dans la liste Symbole de devise, sélectionnez un symbole de devise, par exemple, Dollars ($).

  • Dans la liste Nombre négatif, sélectionnez le mode d'affichage des nombres négatifs, par exemple, (123).

  • Dans la liste Echelle, sélectionnez une valeur mise à l'échelle pour les nombres, par exemple, 1 000.

• Texte

• True ou False

• Utilisateur

• Oui ou Non

Calcul

Les attributs calculés sont en lecture seule. Les calculs peuvent uniquement être évalués par rapport à des masques de saisie :

• Masques de saisie : lorsque vous êtes dans une vue de type Liste des tâches, Gantt ou Tableau de bord BI, vous pouvez ajouter un calcul pour l'évaluer, qu'il ait été explicitement affecté à la tâche ou non.

• Modèles : vous ne pouvez pas ajouter un attribut personnalisé pour lequel l'option Calcul est sélectionnée en tant que colonne ou qu'attribut filtrable.

Les administrateurs peuvent ajouter des attributs aux sections des attributs dans les boîtes de dialogue Actions. Les utilisateurs de workflow pourront les visualiser. Les administrateurs peuvent restreindre l'accès à certains rôles en définissant l'accès sur Ne pas afficher. Par exemple, un administrateur peut ajouter l'accès Visualiseur : Ne pas afficher à l'attribut calculé XYZ afin que XYZ n'apparaisse pas pour les visualiseurs.

Tout rôle d'utilisateur peut ajouter des attributs calculés en tant que colonnes dans les vues et les portlets. Ces derniers peuvent également être ajoutés en tant qu'attributs filtrables dans le panneau des filtres.

Lorsque vous sélectionnez Calcul, une section de définition de calcul est affichée :

• Type de calcul : la liste de valeurs est déterminée par le type d'attribut :

  • Affecter une valeur à la liste : affectez des valeurs personnalisées à un attribut de type Liste.

  • Affecter une liste à la valeur : affectez des valeurs de liste personnalisées aux valeurs d'un autre attribut.

  • Conditionnel : calcul conditionnel (If – Then – Else)

  • A partir de scripts : calcul à partir de scripts de format libre. L'option A partir de scripts est disponible pour les attributs de type Entier, Texte multi-ligne, Nombre.

  Le tableau suivant répertorie les types de calcul que chaque type d'attribut peut utiliser lorsque l'option de calcul est sélectionnée :

  Tableau 3-2 Définition des attributs

  Type d'attribut	Affecter une valeur à la liste	Conditionnel	A partir de scripts	Affecter une liste à la valeur
  Date
  Date/heure
  Entier	X	X	X
  Liste		X		X
  Texte multi-ligne	X	X	X
  Nombre	X	X	X
  Texte	X	X	X
  True/False		X
  Utilisateur
  Oui/Non		X

• Lorsque vous sélectionnez le type de calcul A partir de scripts, utilisez Ajouter un attribut et Ajouter une fonction pour saisir une équation de calcul de format libre :

  Ajouter un attribut : sélectionnez un attribut et cliquez sur pour l'insérer dans la Définition de calcul à l'emplacement du curseur. Si le curseur se trouve au milieu d'un mot ou d'un attribut, le mot/l'attribut sera remplacé dans la définition. Le nom des attributs ajoutés sera placé entre accolades {}, conformément au format de script.

• Ajouter une fonction : sélectionnez une fonction et cliquez sur pour l'ajouter à Définition de calcul. La fonction est ajoutée avec des espaces réservés pour chaque paramètre.

  Par exemple, insérez la fonction DATE_DIFF dans la définition de calcul :

  DATE_DIFF(<Date1>, <Date2>, <Type>)

  Remplacez ensuite les espaces réservés par des attributs :

  DATE_DIFF( {Start Date}, {End Date}, 'DAYS')

  Voici d'autres exemples de fonctions de script :

  • Ajouter un mois : renvoie une date décalée d'un nombre de mois indiqué à partir de la date de début. La date sera toujours conforme au décalage de mois indiqué. Si la date de début présente une valeur qui va au-delà du mois de décalage, le dernier jour du mois sera utilisé. Par exemple, EDate (31-Jan-2017, 1) renvoie (28-Feb-2017). Pour les mois, saisissez le nombre de mois précédant ou suivant la date de début. Une valeur positive pour les mois génère une date future. Une valeur négative génère une date passée.

    EDate(<Start Date>, <Months>, <Length>)

    Exemple : EDate(DATE(2017, 2, 15) 3)

  • Date : renvoie une valeur de date qui dépend des valeurs d'entier spécifiées pour l'année, le mois et le jour. Par exemple, cette fonction crée une valeur de type Date à partir de la fonction, ainsi la conversion de DATE(2018, 5, 31) sera 31 mai 2018. Elle peut ensuite être utilisée dans la fonction Différence de date pour extraire la différence en jours entre une date, telle qu'une date de fin, et cette date spécifique.

    DATE(<Année>, <Mois>, <Jour>)

  • Ecart de date : renvoie l'écart entre deux dates en jours, heures, minutes ou secondes. Pour Date1 et Date 2, les valeurs 'TODAY' et 'NOW' peuvent être utilisées pour indiquer la date en cours (sans composant d'heure) et, la date et l'heure, respectivement.

    Les types valides sont DAYS, HOURS, MINUTES, SECONDS.

    DATE_DIFF(<Date1>, <Date2>, <Type>)

    Exemple : DATE_DIFF('TODAY', {Preparer End Date}, 'DAYS') ou DATE_DIFF({Preparer End Date}, 'NOW', 'HOURS')

  • Jour : renvoie la valeur de jour d'une date en tant que nombre entier

    DAY(<DATE>)

  • Extraire le texte : renvoie la sous-chaîne figurant dans la valeur, à partir des positions spécifiées.

    SUBSTRING(<Value>, <Location>, <Length>)

    Exemple : SUBSTRING( {Name} , 5, 10)

  • If-Then-Else : permet à l'utilisateur d'insérer un calcul conditionnel dans le calcul de script. Les calculs IF_THEN_ELSE peuvent être imbriqués pour prendre en charge également les calculs de type "ELSE IF".

    IF_THEN_ELSE(<Condition>, <Value1>, <Value2>)

    Exemple : ,

    IF_THEN_ELSE( ( {Priority} = 'Low'), 'Good'
    IF_THEN_ELSE( ( {Priority} = 'Medium'), 'Better'. 'Best') )

  • Instring : renvoie la valeur de la recherche.

    INSTRING(<Valeur1>, <Valeur à rechercher>)

    Exemple : INSTRING({Name}, 'a')

  • Minuscules : renvoie la valeur en minuscules.

    LOWERCASE(<Valeur>)

    Exemple : LOWERCASE ({Task Code})

  • Maximum : renvoie la valeur maximale d'une liste d'attributs. Le nombre de paramètres n'est pas défini.

    MAX (<Valeur1>, <Valeur2>, <ValeurN>)

    Exemple : MAX( {Scripted Substring Loc a}, {Scripted Substring Loc s}, {Scripted Substring Loc t} )

  • Minimum : renvoie la valeur minimale d'une liste d'attributs. Le nombre de paramètres n'est pas défini.

    MIN (<Value1>, <Value2>, <ValueN>)

    Exemple : MIN( {Scripted Substring Loc a}, {Scripted Substring Loc s}, {Scripted Substring Loc t} )

  • Mois : renvoie la valeur de mois d'une date en tant que nombre entier (1-12)

    MONTH (<DATE>)

  • Arrondi : renvoie la valeur arrondie au nombre de décimales spécifié.

    ROUND <Valeur1>, <Nombre de décimales>)

    Exemple : ROUND( ({Scripted Substring Loc t} / 7), '4')

  • Sous-chaîne :

    SUBSTRING(<Valeur>, <Emplacement>, <Longueur>)

    Exemple : SUBSTRING( {Name}, 4, 10)

  • Emplacement du texte : renvoie l'index de la sous-chaîne se trouvant dans la valeur, la première position étant 1.

    INSTRING(<Valeur>, <Valeur à rechercher>)

    Exemple : INSTRING( UPPERCASE( {Name} ), 'TAX' )

  • Majuscules : renvoie la valeur en majuscules.

    UPPERCASE(<Valeur>)

    Exemple : UPPERCASE( {Name} )

  • Année : renvoie la valeur d'année d'une date en tant que nombre entier.

    YEAR (<DATE>)

La syntaxe du calcul est correcte.

Les attributs et les fonctions spécifiés dans le calcul existent.

Les paramètres pour les fonctions sont corrects.

Aucune boucle circulaire n'existe.