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 d'attribut de dimension historiques dans les formulaires existants.

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

Sur la page d'accueil, cliquez sur Application, puis sur Supplemental Data.
Cliquez sur l'onglet Collectes à gauche.
Sélectionnez une collecte et cliquez sur Modifier. La fenêtre Modifier la collecte apparaît.
Cliquez sur l'onglet Attributs. Il contient les colonnes suivantes :
- Identificateur clé : indique si l'attribut est un identificateur clé. S'il n'existe pas de données pour cette collecte, vous pouvez modifier l'identificateur clé et les attributs.
  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'attribut Identificateur clé. Si vous sélectionnez ce type d'attribut comme identificateur clé, vous risquez de constater 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 uniquement applicable au type d'attribut Référence de dimension.
- Nom : nom de l'attribut.
- Nom de la dimension : cette colonne est uniquement applicable à l'attribut de dimension et fournit le nom de la dimension.
- Type d'attribut (colonne affichée s'il existe des attributs) : 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.
  - Moyen : 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é.
Cliquez sur l'icône Ajouter, puis sur l'une des options suivantes :
- Ajouter un attribut : la fenêtre Créer un attribut apparaît. Reportez-vous à la section Ajout d'un nouvel attribut à une collecte.
- Ajouter un attribut à partir de la dimension : la fenêtre Ajouter un attribut à partir de la dimension apparaît. Reportez-vous à la section Ajout d'attributs à partir d'une dimension.

Ajout d'un nouvel attribut à une collecte

Pour ajouter un nouvel attribut à une collecte, procédez comme suit :

Dans la fenêtre Créer un attribut, renseignez les options suivantes dans l'onglet Propriétés :
- Nom : entrez le nom de l'attribut. Vous pouvez saisir jusqu'à 80 caractères.
- Description : saisissez une description. Vous pouvez saisir jusqu'à 255 caractères.
- Sélectionnez l'option Entrée ou Calculé dans le 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 enregistré l'attribut, vous ne pouvez pas 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'un des types de données suivants. Après avoir sélectionné le type de données, vous pouvez également sélectionner les options Requis et/ou Utiliser la valeur.
  - Date
  - Date/Heure
  - Entier
  - Liste : cliquez sur Ajouter et saisissez les valeurs de l'attribut. La liste est propre à la collecte et il n'est pas possible de la partager.
  - Texte multi-ligne : si vous sélectionnez cette option, sélectionnez le nombre de lignes (de 3 à 50 lignes). La valeur par défaut est 3. L'option 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 est de 2 000 caractères. Cependant, la largeur de la zone de texte reste fixe.
    Cochez la case Requis si le type de données doit contenir une valeur. Si vous cochez la case Utiliser la valeur, la valeur saisie pour Nombre de lignes sera également applicable ici par défaut. Au-delà de cette valeur, le texte sera visible par défilement.
  - Nombre : sélectionnez cette option pour indiquer les options de formatage. Les paramètres par défaut de la section Préférences des paramètres système seront remplacés.
    
    Remarque :
    Pour cet attribut, vous ne pouvez saisir que des valeurs de type numérique.
    - 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 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 : met le nombre à l'échelle. Plage : de 1 000 à 1 000 000 000 000.
  - Texte : saisissez jusqu'à 255 caractères.
  - True/False
  - Oui/Non
- Requis : si l'attribut est requis, vous devez entrer une valeur pour ce champ lors de la saisie des données.
- Utiliser la valeur : si vous renseignez ce champ, 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.
Cliquez sur OK pour enregistrer l'attribut. La fenêtre Créer un attribut se ferme.
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 pourrez ainsi accéder aux onglets Validations et Calcul de l'attribut.
Sélectionnez l'attribut que vous avez créé et cliquez sur l'icône Modifier.
La fenêtre Modifier l'attribut apparaît.
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 dans la première ligne pour afficher les listes déroulantes, dans lesquelles vous pouvez sélectionner l'opérateur et saisir des valeurs pour Value1 et Value2.
3. Si vous avez besoin d'une deuxième condition, cliquez sur Ajouter pour ajouter une ligne.
4. Cliquez sur les colonnes dans la deuxième ligne pour afficher les listes déroulantes, dans lesquelles vous pouvez sélectionner la conjonction, par exemple Et ou Ou.
5. Cliquez sur OK pour enregistrer les conditions.
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 et sélectionnez l'attribut et la fonction.

Pour ajouter une expression de calcul, indiquez un type de données et un type de calcul, comme décrit dans le tableau suivant.

Tableau 32-2 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.

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 supérieur ou égal à zéro, ce nombre est renvoyé.
ABS(<Nombre>)
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édente : fait la moyenne d'un montant numérique sur les X périodes précédentes.
AVERAGE_PRIOR(<Value>, <Number of Periods>, <To Currency*>

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 : prend une valeur de texte comme paramètre et renvoie un entier représentant le nombre de caractères dans le 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 dans le 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(<Value>)

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 (<Value>, <Number of Periods>)

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(<Value1>, <Value2>,<ValueN>)

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 (<Value>, (<Value>, <Number oMIN_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.

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

Exemple : POWER(3,4)=81

Remarque :

Les valeurs fractionnaires réduiront le nombre de ses racines. Par exemple, POWER(27, 1/3) = 3 est la racine cubique.

Les valeurs négatives réaliseront un 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(<Value>, <Number of Periods Prior>)

Exemple : PRIOR( {Source System Balance (Entered)}, '1', 'EUR'')
Arrondi : renvoie la valeur arrondie au nombre de décimales spécifié..

ROUND(<Value>, <Decimal Places>)

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(<Value>, <Number of Periods>)

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(<Value>, <To Currency>, <Rate Type>)

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

Exemple d'ajout d'attribut de calcul

Créez une collecte avec les attributs suivants :
Int1 : attribut de type Entrée, dont le type de données est Entier. Cliquez sur OK, puis dans Modifier la collecte, sélectionnez Int1 comme identificateur clé.

TextInput : attribut de type Entrée, dont le type de données est Texte.
Enregistrez les données.
Créez un attribut nommé TextCalc de type Calculé, dont le type de données est Texte.
Dans l'onglet Calculs, renseignez les champs suivants :
- Type de calcul : sélectionnez A partir de scripts.
- Ajouter une fonction : sélectionnez TextLocation et cliquez sur Ajouter.
  INSTRING(<Value>, <Value To Search>) est ajouté à la définition de calcul.
- Cliquez sur <Value> et entrez une valeur (entre guillemets simples et respectant la casse) ou, dans Ajouter un attribut, sélectionnez l'attribut TextInput, puis cliquez sur Ajouter.
  
  <Value> devient {TextInput}.
- Remplacez <Value to Search> par 'tion'.
  Remarque : veillez à remplacer <xxx> par des guillemets simples : 'xxx'. Exemple : INSTRING({TextInput}, 'tion')
Cliquez sur OK pour enregistrer les attributs.

Ajout d'attributs à partir d'une dimension

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

Sélectionnez une dimension.
Sélectionnez des attributs dans 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é.
Cliquez sur OK.
La fenêtre Ajouter un attribut à partir de la dimension se ferme et les attributs sélectionnés sont affichés dans la fenêtre Modifier la collecte.
Vous pouvez cocher la case dans la colonne Persistant pour indiquer que la valeur de l'attribut de dimension doit être conservée dans les formulaires référencés. Si l'attribut de dimension est mis à jour, les modifications ne sont pas mises à jour 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 en fonction des dernières modifications. Une fois la collecte enregistrée, vous ne pouvez pas modifier ce paramètre.
Cliquez sur Enregistrer ou Enregistrer et fermer.