A propos des attributs calculés

Les attributs calculés sont en lecture seule.

Les administrateurs peuvent ajouter des attributs calculés aux sections d'attributs dans les boîtes de dialogue Actions, et les utilisateurs de workflow peuvent les consulter dans les boîtes de dialogue Actions et dans les transactions. 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 listes. Ces derniers peuvent également être ajoutés en tant qu'attributs filtrables dans le panneau des filtres.

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 :

Table 4-1 Types de calcul que chaque type d'attribut peut utiliser lorsque l'option de calcul est sélectionnée

Type d'attribut Affecter une valeur à la liste Conditionnel A partir de scripts Affecter une liste à la valeur
Date     X  
Date/heure     X  
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    

Exemples de fonction à partir de scripts

Pour toutes les fonctions numériques, toute valeur NULL dans l'entrée est ignorée lors du calcul du résultat.

  • 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(<Date de début>, <Mois>, <Longueur>)

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

  • Fonction Moyenne sur les périodes précédentes : fait la moyenne d'un montant numérique sur les X périodes précédentes.

    AVERAGE_PRIOR(<Valeur>, <Nombre de périodes>, <Devise cible*>, <Type de taux*>, <Période de taux*>

    Exemple : AVERAGE_PRIOR( {Source System Balance (Reporting)}, '2', 'EUR', 'REC')

    Note:

    Les paramètres avec un astérisque, *, sont obligatoires si la valeur est un attribut de type solde comme Système source. Si la valeur est normale (comme un attribut numérique), vous devez omettre les paramètres *.

    Note:

    Le type de taux doit être un type de taux valide sur le système ou la valeur 'REC', qui signifie que le taux de change appliqué est celui affecté au rapprochement. Le paramètre Période de taux doit être défini sur 'CURRENT' ou 'PRIOR', c'est-à-dire que lors de la conversion de la devise, les types de taux de la période en cours ou de la période précédente sont appliqués.

  • 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, la conversion de DATE(2018, 5, 31) donnerait donc le 31 mai 2018. Ceci peut ensuite servir dans la fonction de différence de date, pour extraire la différence en nombre de jours entre une date, par exemple une date de fin, et cette date spécifique.

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

    Vous pouvez également employer les dates PERIOD START, PERIOD END ou PERIOD CLOSE lorsque vous créez un attribut de données calculé. Par exemple, si vous voulez comparer la date CLOSED DATE d'une transaction Ajustement à la date PERIOD END.

  • 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. Texte extrait/Emplacement du texte utilise la valeur 1 pour le premier caractère.

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

    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 également être imbriqués pour prendre en charge les calculs de type "ELSE IF".

    IF_THEN_ELSE(<Condition>, <Valeur1>, <Valeur2>)

    Exemple :

    IF_THEN_ELSE( {Risk Rating} = 'Low', 'Good',
IF_THEN_ELSE( {Risk Rating} = 'Medium', 'Better',
IF_THEN_ELSE({Risk Rating} = 'High', 'Best','Bad')))

  • Instring : renvoie l'index de la sous-chaîne dans la valeur.

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

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

  • Longueur : prend une valeur textuelle comme paramètre et renvoie un entier correspondant au nombre de caractères dans le texte.

    LENGTH('Value') renvoie 5 et LENGTH({Name}) renvoie le nombre de caractères dans le nom de l'objet. Si la valeur est vide/NULL, le calcul renvoie 0.

    Utilisez le calcul avec SUBSTRING pour extraire les 4 derniers caractères d'une valeur textuelle.

    Exemple : SUBSTRING( {MyString}, LENGTH ({MyString}) - 4

  • Minuscules : renvoie la valeur en minuscules.

    LOWERCASE(<Valeur>)

    Exemple : LOWERCASE( {Description} )

  • 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( TRANSLATE( {Source System Balance (Entered)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Functional)}, 'USD', 'Accounting'), TRANSLATE( {Source System Balance (Reporting)}, 'USD', 'Accounting') )

  • Maximum précédent : renvoie la valeur maximale sur les X périodes précédentes.

    MAX_PRIOR (<Valeur>, <Nombre de périodes>, <Devise cible*>, <Type de taux*>, <Période de taux*>)

    Exemple : MAX_PRIOR( {Source System Balance (Functional)}, '6', 'CAD', 'REC', 'CURRENT')

    Note:

    Les paramètres avec un astérisque, *, sont obligatoires si la valeur est un attribut de type solde comme Système source. Si la valeur est normale (comme un attribut numérique), vous devez omettre les paramètres *.

    Note:

    Le type de taux doit être un type de taux valide sur le système ou la valeur 'REC', qui signifie que le taux de change appliqué est celui affecté au rapprochement. Le paramètre Période de taux doit être défini sur 'CURRENT' ou 'PRIOR', c'est-à-dire que lors de la conversion de la devise, les types de taux de la période en cours ou de la période précédente sont appliqués.

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

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

    Exemple : MIN( TRANSLATE( {Source System Balance (Entered)}, 'CAD', 'REC'), TRANSLATE( {Source System Balance (Functional)}, 'CAD', 'REC'), TRANSLATE( {Source System Balance (Reporting)}, 'CAD', 'REC') )

  • Minimum précédent : renvoie la valeur minimale sur les X périodes précédentes.

    MIN_PRIOR (<Valeur>, <Nombre de périodes>, <Devise cible*>, <Type de taux*>, <Période de taux*>)

    Exemple : MIN_PRIOR( {Source System Balance (Functional)}, '6', 'EUR', 'Simplified')

    Note:

    Les paramètres avec un astérisque, *, sont obligatoires si la valeur est un attribut de type solde comme Système source. Si la valeur est normale (comme un attribut numérique), vous devez omettre les paramètres *.

    Note:

    Le type de taux doit être un type de taux valide sur le système ou la valeur 'REC', qui signifie que le taux de change appliqué est celui affecté au rapprochement. Le paramètre Période de taux doit être défini sur 'CURRENT' ou 'PRIOR', c'est-à-dire que lors de la conversion de la devise, les types de taux de la période en cours ou de la période précédente sont appliqués.

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

    MONTH (<DATE>)

  • Puissance : élève un nombre à la puissance exponentielle d'un autre.

    POWER(x,y) où x = BASE NUMBER et y = EXPONENT, x et y peuvent être des attributs ou des calculs, à condition qu'ils soient numériques.

    Exemple : POWER(3,4)=81

    Note:

    Les valeurs fractionnaires réduiront le nombre à sa racine. Par exemple, POWER(27, 1/3) = 3 la racine cubique.

    Note:

    Les valeurs négatives exécuteront un inverse du calcul exponentiel. Par exemple, POWER(2, -2) = 1 / (2^2) = 1 / 4 = 0,25.

  • Précédent : renvoie la valeur de la période précédente spécifiée. Si le nombre de périodes précédentes est omis, la valeur est définie sur 1.

    PRIOR(<Valeur>, <Nombre de périodes précédentes*>, <Devise cible*>, <Type de taux*>, <Période de taux*>)

    Exemple : PRIOR( {Source System Balance (Entered)}, '1', 'EUR', 'rec', 'prior')

    Note:

    Les paramètres avec un astérisque, *, sont obligatoires si la valeur est un attribut de type solde comme Système source. Si la valeur est normale (comme un attribut numérique), vous devez omettre les paramètres *.

    Note:

    Le type de taux doit être un type de taux valide sur le système ou la valeur 'REC', qui signifie que le taux de change appliqué est celui affecté au rapprochement. Le paramètre Période de taux doit être défini sur 'CURRENT' ou 'PRIOR', c'est-à-dire que lors de la conversion de la devise, les types de taux de la période en cours ou de la période précédente sont appliqués.

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

    ROUND(<Valeur>, <Nombre de décimales>)

    Exemple : ROUND( ({Scripted Translate} /7), 4)

  • Somme précédente : renvoie la somme d'une valeur sur les X périodes précédentes.

    SUM_PRIOR(<Valeur>, <Nombre de périodes>, <Devise cible*>, <Type de taux*>, <Période de taux*>)

    Exemple : SUM_PRIOR( {Source System Balance (Reporting)}, '3', 'EUR', 'REC')

    Note:

    Les paramètres avec un astérisque, *, sont obligatoires si la valeur est un attribut de type solde comme Système source. Si la valeur est normale (comme un attribut numérique), vous devez omettre les paramètres *.

    Note:

    Le type de taux doit être un type de taux valide sur le système ou la valeur 'REC', qui signifie que le taux de change appliqué est celui affecté au rapprochement. Le paramètre Période de taux doit être défini sur 'CURRENT' ou 'PRIOR', c'est-à-dire que lors de la conversion de la devise, les types de taux de la période en cours ou de la période précédente sont appliqués.

  • 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' )

  • Convertir : convertit un attribut de devise en un attribut numérique à l'aide d'un type de taux spécifié.

    TRANSLATE(<Valeur>, <Devise cible>, <Type de taux>)

    Exemple : TRANSLATE( {Source System Balance (Entered)}, 'EUR', 'Accounting')

    Note:

    Le type de taux doit être un type de taux valide sur le système ou la valeur 'REC', qui signifie que le taux de change appliqué est celui affecté au rapprochement.

  • 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>)