Ajout d'attributs de collecte

Les attributs sont des champs définis de manière centrale par les administrateurs et utilisés à de nombreux emplacements. Vous pouvez spécifier différents types de valeur pour les attributs : Date, Date et heure, Liste, Nombre, Texte et True/False.

Pour les collectes, vous pouvez ajouter des attributs de calcul de date, tels que Date de début et Date de fin, pour une période de collecte de données. Vous pouvez également conserver les valeurs historiques d'attribut de dimension sur les formulaires de données existants.

Pour ajouter des attributs de collecte, procédez comme suit :

  1. Sur la page d'accueil, cliquez sur Application, puis sur Supplemental Data.
  2. Cliquez sur l'onglet Collectes à gauche.
  3. Sélectionnez une collecte, puis cliquez sur Modifier. La fenêtre Modifier la collecte apparaît.
  4. Cliquez sur l'onglet Attributs. Les colonnes suivantes sont affichées :
    • Identificateur clé : indique si l'attribut est un identificateur clé ou non. S'il n'existe pas encore de données pour cette collecte, vous pouvez modifier ses attributs et l'option Identificateur clé.

      Remarque :

      • Les cases Identificateur clé et Affecter un workflow de l'entité sont cochées par défaut. Lorsque vous ajoutez des attributs, vous pouvez en sélectionner certains comme identificateur clé.
      • Supplemental Data Manager ne prend pas en charge les attributs de type Calculé en tant qu'attributs Identificateur clé. Si vous sélectionnez ce type d'attribut en tant qu'identificateur clé, vous pourrez rencontrer un comportement inattendu et des erreurs dans les collectes.
    • Affecter un workflow : affiche le workflow défini dans l'intervalle de collecte. Non modifiable.
    • Persistant : indique si la valeur de l'attribut de dimension doit être conservée dans les formulaires référencés. Cette colonne est applicable uniquement pour le type d'attribut Référence de dimension.
    • Nom : nom de l'attribut.
    • Nom de la dimension : cette colonne est applicable uniquement pour l'attribut de dimension et indique le nom de la dimension.
    • Type d'attribut (affiché en cas d'attributs existants) : indique le type d'attribut :
      • Entrée
      • Référence de dimension
      • Calculé
    • Type de données : Date, Date et heure, Entier, Liste, Texte multi-ligne, Nombre, Texte, True/False ou Oui/Non.
    • Total : vous permet d'indiquer la méthode de comptabilisation pour l'attribut :
      • Somme : total par addition.
      • Moyenne : moyenne des lignes contenant des données. Les lignes sans données ne sont pas prises en compte dans le dénominateur.
      • Nombre : nombre de lignes contenant des données.
      • Aucun : le total n'est pas calculé.
  5. Cliquez sur l'icône Ajouter, puis sur l'une des options suivantes :

Ajout d'un nouvel attribut pour une collecte

Afin d'ajouter un nouvel attribut pour une collecte, procédez comme suit :

  1. Dans la fenêtre Créer un attribut, indiquez les éléments suivants dans l'onglet Propriétés :
    • Nom : entrez le nom de l'attribut. Vous pouvez saisir jusqu'à 255 caractères.
    • Description : saisissez une description. Vous pouvez saisir jusqu'à 255 caractères.
    • Sélectionnez l'option Entrée ou Calculé comme type d'attribut.

      Entrée est la valeur par défaut et l'onglet Validations est activé. Pour les périodes qui ont été ouvertes et pour lesquelles des instances de formulaire ont été créées, la règle de validation modifiée ne s'applique pas. Les modifications effectuées s'appliquent uniquement aux nouvelles instances de formulaire.

      Si vous sélectionnez Calculé, l'onglet Calculs est activé.

      Remarque :

      Après avoir sélectionné Entrée ou Calculé et avoir enregistré l'attribut, vous ne pouvez plus modifier ce paramètre une fois l'attribut créé. La modification du type d'attribut remplace les validations ou les calculs indiqués précédemment.
    • Type de données : sélectionnez l'une des options suivantes comme type de données. Une fois le type de données sélectionné, vous pouvez également sélectionner les options Obligatoire et/ou Utiliser la valeur.
      • Date
      • Date/Heure
      • Entier
      • Liste : cliquez sur Ajouter et saisissez des valeurs pour l'attribut. La liste est propre à la collecte et ne peut pas être partagée.
      • Texte multi-ligne : si vous sélectionnez cette option, indiquez le nombre de lignes (de 3 à 50 lignes). La valeur par défaut est 3. Texte multi-ligne détermine le nombre de lignes de texte visibles dans le formulaire, sans défilement, sur les boîtes de dialogue Actions. La longueur maximale doit être égale à 2 000 caractères. Cependant, la largeur reste fixe pour la zone de texte.

        Cochez la case Requis si le type de données doit obligatoirement contenir cette valeur. Si vous cochez la case Utiliser la valeur, la valeur que vous avez saisie pour le nombre de lignes sera également applicable ici par défaut. Au-delà, il s'agira d'un texte à faire défiler.

      • Nombre : sélectionnez cette option pour indiquer les options de format. Cette action remplace les paramètres par défaut de la section Préférences des paramètres système.

        Remarque :

        Vous pouvez saisir uniquement des valeurs numériques pour cet attribut.
        • Nombre de décimales : entrez le nombre de décimales à afficher.
        • Afficher en pourcentage : affiche le signe du pourcentage.
        • Utiliser le séparateur de milliers : affiche les nombres avec un séparateur des milliers (par exemple, 1 000,00). Le système affiche le symbole de séparateur de milliers associé aux paramètres régionaux de l'utilisateur.
        • Devise : sélectionnez la devise.
        • Format de nombre négatif : sélectionnez le mode d'affichage des nombres négatifs
        • Echelle : mettez le nombre à l'échelle. La plage est comprise entre 1 000 et 1 000 000 000 000.
      • Texte : saisissez jusqu'à 255 caractères.
      • True/False
      • Oui/Non
    • Obligatoire : si l'attribut est obligatoire, vous devez entrer une valeur pour ce champ lors de la saisie des données.
    • Utiliser la valeur : si vous spécifiez cette valeur, le système applique la valeur indiquée par le concepteur à tous les enregistrements créés par l'utilisateur. Vous pouvez modifier la valeur par défaut lors de la saisie des données.
  2. Cliquez sur OK pour enregistrer l'attribut. La fenêtre Créer un attribut se ferme.
  3. Dans la fenêtre Modifier la collecte, cliquez sur Enregistrer pour enregistrer la collecte.

    Remarque :

    Vous devez enregistrer le nouvel attribut et la collecte. Vous ne pourrez accéder à l'onglet Validations ou à l'onglet Calcul de l'attribut qu'une fois cette action effectuée.
  4. Sélectionnez l'attribut que vous avez créé, puis cliquez sur l'icône Modifier.

    La fenêtre Modifier l'attribut apparaît.

  5. Si vous avez sélectionné l'option Entrée (étape 1), vous pouvez ajouter une expression conditionnelle dans l'onglet Validations :
    1. Cliquez sur Ajouter. Une ligne est ajoutée à la table.
    2. Cliquez sur les colonnes de la première ligne pour afficher les listes déroulantes, dans lesquelles vous pouvez sélectionner l'opérateur et saisir une valeur 1 et une valeur 2 en conséquence.
    3. Si vous avez besoin d'une deuxième condition, cliquez sur Ajouter pour ajouter une autre ligne.
    4. Cliquez sur les colonnes de la deuxième ligne pour afficher les listes déroulantes, dans lesquelles vous pouvez sélectionner la conjonction, telle que Et ou Ou.
    5. Cliquez sur OK pour enregistrer les conditions.
  6. Si vous avez sélectionné l'option Calculé (étape 1), vous pouvez ajouter un calcul dans l'onglet Calculs. Sélectionnez le type de calcul :
    • Affecter une valeur à la liste : sélectionnez l'attribut associé.
    • Conditionnel : ajoutez la condition pour la définition de calcul.
    • A partir de scripts : fournissez la définition de calcul, puis sélectionnez l'attribut et la fonction.
  7. Pour ajouter une expression de calcul, indiquez le type de données et le type de calcul tel que décrit dans le tableau suivant.

    Tableau 38-3 Type de données et type de calcul

    Type de données sélectionné dans l'onglet Propriétés Type de calcul Description
    Pour tous les types de données Sélectionnez Affecter une valeur à la liste, puis la valeur Attribut.

    Vous devez avoir enregistré les valeurs d'attribut de la liste.

    		 Renvoie une valeur d'attribut en fonction de l'affectation à un membre de liste.
    Pour tous les types de données Conditionnel Pour un attribut donné, renvoie la valeur d'attribut A si les conditions spécifiées sont remplies. Renvoie la valeur d'attribut B si elles ne le sont pas.
    Liste Affecter une liste à la valeur En fonction de la valeur d'un attribut, renvoie le membre associé de la liste.
         
         
         
    Entier, Nombre, Texte A partir de scripts

    Reportez-vous à la section Fonctions à 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.
  8. Cliquez sur OK pour enregistrer l'attribut.

    Remarque :

    Les modifications apportées aux attributs ne s'appliquent qu'aux périodes de collecte de données suivantes.

Fonctions à partir de scripts

  • Valeur absolue : renvoie la valeur absolue d'un nombre spécifié. Si un nombre est inférieur à zéro, la valeur positive du nombre est renvoyée. Si le nombre indiqué est égal ou supérieur à zéro, ce nombre est renvoyé.

    ABS(<Number>)

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

    ADD_MONTH(<Date de début>, <Mois>, <Longueur>)

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

  • Moyenne - précédent : 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*>

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

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

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

  • Ecart de date : renvoie l'écart entre deux dates en jours, heures, minutes ou secondes. Pour DATE 1 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.

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

    Exemple : DATE_DIFF('TODAY', {Preparer End Date}, 'DAYS') or 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(<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')))
  • Longueur : accepte une valeur de texte en tant que paramètre et renvoie un entier qui correspond au nombre de caractères du texte. Si la valeur est vide/NULL, le calcul renvoie 0.

    Length ({<attribute>})

    Exemple : LENGTH('Value') renvoie 5 et LENGTH({Name}) renvoie le nombre de caractères du nom de l'objet.

    Utilisez le calcul avec SUBSTRING pour extraire les quatre derniers caractères d'une valeur de texte.

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

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

  • 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( { Balance (Entered)}, 'CAD', 'REC'), TRANSLATE( {Balance (Functional)}, 'CAD', 'REC'), TRANSLATE( {Balance (Reporting)}, 'CAD', 'REC') )

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

    MIN_PRIOR (<Valeur>, (<Valeur>, <Nombre de périodes>)

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

  • 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 nombre.

    POWER(x,y) où x=BASE NUMBER et y=EXPONENT. x et y peuvent être des attributs ou des calculs, tant qu'il s'agit de valeurs numériques.

    Exemple : POWER(3,4)=81

    Remarque :

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

    Les valeurs négatives réaliseront l'inverse du calcul exponentiel. Par exemple, POWER(2, -2) = 1 / (2^2) = 1 / 4 = .25.

  • Précédent : renvoie la valeur de la période précédente spécifiée.

    PRIOR(<Valeur>, <Nombre de périodes précédentes>)

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

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

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

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

    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( {Balance (Entered)}, 'EUR', 'Acct')

  • Majuscules : renvoie la valeur en majuscules.

    UPPERCASE(<Value>)

    Exemple : UPPERCASE( {Name} )

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

    YEAR (<DATE>)

Exemple d'ajout d'un attribut de calcul

  1. Créez une collecte avec les attributs suivants :

    Int1 : Entrée comme type d'attribut et Type de données défini sur Entier. Cliquez sur OK, puis, dans la fenêtre Modifier la collecte, sélectionnez Int1 comme identificateur clé.

    TextInput : Entrée comme type d'attribut et Type de données défini sur Texte.

  2. Enregistrez les données.
  3. Créez un attribut nommé TextCalc avec le type d'attribut Calculé et Type de données défini sur Texte.
  4. Dans l'onglet Calculs, renseignez les champs suivants :
    • Type de calcul : sélectionnez A partir de scripts.
    • Ajouter une fonction : sélectionnez TextLocation, puis cliquez sur Ajouter.

      INSTRING(<Valeur>, <Valeur à rechercher>) est ajouté à Définition de calcul.

    • Cliquez sur <Valeur>, puis saisissez une valeur (entre guillemets simples et respectant la casse) ou, dans Ajouter un attribut, sélectionnez l'attribut TextInput, puis cliquez sur Ajouter.

      <Valeur> est remplacé par {TextInput}.

    • Remplacez <Valeur à rechercher> par 'tion'.

      Remarque : veillez à placer <xxx> entre apostrophes : 'xxx'. Par exemple, INSTRING({TextInput}, 'tion')

  5. Cliquez sur OK pour enregistrer les attributs.

Ajout d'attributs à partir de la dimension

Dans la fenêtre Ajouter un attribut à partir de la dimension, procédez comme suit :

  1. Sélectionnez une dimension.
  2. Sélectionnez des attributs à partir de la liste Attributs disponibles et déplacez-les dans la liste Attribut sélectionné.

    Le système inclut l'attribut de clé de la dimension comme attribut sélectionné. Vous ne pouvez pas effacer l'attribut clé.

  3. Cliquez sur OK.

    La fenêtre Ajouter un attribut à partir de la dimension se ferme et les attributs sélectionnés apparaissent dans la fenêtre Modifier la collecte.

  4. Vous pouvez cocher la case dans la colonne Persistant pour indiquer que la valeur de l'attribut doit être conservée dans les formulaires référencés. Si l'attribut de dimension est mis à jour, les modifications ne seront pas apportées dans les formulaires dans lesquels l'attribut est référencé. Si vous ne cochez pas cette case, l'attribut référencé est mis à jour avec les dernières modifications. Une fois la collecte enregistrée, vous ne pouvez pas modifier ce paramètre.
  5. Cliquez sur Enregistrer ou Enregistrer et fermer.