Format du fichier de chargement de demande

Cette rubrique présente le format des feuilles de calcul Microsoft Excel utilisé pour charger des éléments de demande.

Remarques

• Chaque feuille de calcul d'un fichier de feuille de calcul correspond à un point de vue.

• Vous pouvez charger plusieurs feuilles de calcul vers différents points de vue.

• Les feuilles de calcul (et les points de vue correspondants) doivent utiliser des libellés de 30 caractères maximum.

  Remarque :

  Si le nom d'un point de vue dépasse 30 caractères, vous devrez créer un libellé qui sera utilisé pour la feuille de calcul lors du chargement des éléments de demande vers un point de vue. Reportez-vous à la section Inspection d'un point de vue pour plus d'informations sur l'utilisation des libellés.

• Les feuilles de calcul peuvent contenir des formules afin de dériver des valeurs de propriété pour les colonnes standard. Les formules de feuille de calcul peuvent également être utilisées pour les propriétés personnalisées et les propriétés propres à l'application (FCGL, PLN). Les cellules de propriété contenant des valeurs de formule dont le résultat est vide sont ignorées. Cellules de propriété contenant des valeurs de formule qui entraînent le résultat <clear> ou <blank>.

• Les feuilles de calcul sont traitées dans l'ordre, de gauche à droite.

• Les lignes dupliquées dans le fichier d'import ne sont pas traitées pendant le chargement.

• Les dates et les horodatages pour les paramètres régionaux pris en charge doivent correspondre à l'un des modèles de format de date Java suivants :

  • Court

  • Valeur par défaut

  • Long

  • Moyen

  Remarque :

  Pour plus d'informations sur les formats de date et d'heure de Java, reportez-vous à la section Utilisation de formats prédéfinis.

• Si vous avez plus de 10 000 noeuds, créez plusieurs fichiers de chargement contenant chacun moins de 10 000 noeuds.

• Pour les noeuds ajoutés ou insérés dans un point de vue de hiérarchie où le parent est inconnu, utilisez le mot-clé <Unknown> dans la colonne Parent afin que la valeur du parent soit calculée et stockée pour chaque élément de demande. Un administrateur doit avoir défini une expression pour calculer la valeur du parent. Reportez-vous à la section Calcul et stockage du parent d'un noeud.

• Pour calculer les noms des noeuds en cours d'ajout ou d'insertion, laissez la colonne de nom vide, ou utilisez le mot-clé <cn> ou <cn ####>. Le noeud doit être configuré de façon à calculer la valeur de nom. Reportez-vous à la section Calcul et stockage du nom d'un noeud.

Eléments à prendre en compte pour les colonnes

• La feuille de calcul doit contenir des en-têtes de colonne qui correspondent aux noms de colonne réservée ou aux noms de propriétés. Pour en savoir plus, reportez-vous à la section Noms de colonne réservée.

  Remarque :

  Vous ne pouvez pas charger une feuille dont la colonne Name est manquante.

• Les en-têtes de colonne pour les propriétés doivent contenir le nom de la propriété ou un libellé affiché personnalisé de la propriété si un libellé a été configuré (cette option est définie dans l'onglet Propriétés de l'inspecteur de point de vue). Le nom de propriété ne peut pas inclure l'espace de noms. Par exemple, Core.Description n'est pas valide.
• Les colonnes peuvent être dans n'importe quel ordre.
• Si l'en-tête d'une colonne ne correspond à aucun nom de colonne réservée ou nom de propriété, la colonne est ignorée. Ainsi, la feuille de calcul peut comporter des commentaires qui ne seront pas chargés.
• Si le fichier de chargement possède une colonne pour la propriété Nom alternatif :
  • Si le type de noeud en cours de chargement contient la propriété Nom alternatif, les opérations suivantes sont effectuées lors du chargement du fichier :
    • Si une ligne contient un nom de noeud, le nom alternatif est chargé dans la colonne Nom alternatif.
    • Si une ligne ne contient pas de nom de noeud, le nom alternatif est utilisé pour rechercher un noeud correspondant dans le point de vue ayant la même valeur de propriété Nom alternatif.

  • Si le type de noeud en cours de chargement ne contient pas la propriété Nom alternatif, la colonne est ignorée.

Ordre de traitement des lignes

Lorsque vous chargez des enregistrements à partir d'un fichier de demande, le processus de chargement trie le contenu du fichier afin d'ajouter les noeuds parent à un point de vue avant les noeuds enfant. Ainsi, les erreurs de validation sont évitées si la ligne d'un noeud enfant précède la ligne du noeud parent dans le fichier de chargement.

Prenons par exemple un fichier de chargement qui contient une ligne parent, Analytics, précédée dans le fichier par deux lignes enfant, Emily et Jack, qui ont tous deux pour parent Analytics :

Lorsque ce fichier est chargé, le processus de chargement trie le contenu et ajoute d'abord Analytics, puis Emily, Jack et Mary.

Traitement des mots-clés <Blank> et <Clear>, et champs vides

Les mots-clés <blank> et <clear>, et les cellules vides dans le fichier de chargement de demande sont gérés différemment lors du traitement d'un fichier de demande :

• Le mot-clé <clear> efface les valeurs existantes d'une propriété.
• Le mot-clé <blank> définit la valeur vide pour la propriété.
• Les cellules vides du fichier sont ignorées.

Les mots-clés <blank> et <clear>, et les cellules vides sont pris en charge pour tous les types de données. Toutefois, pour les types de données de liste, les entrées vides qui se trouvent dans une liste ne sont pas prises en charge. Autrement dit, la liste peut être vide, mais les entrées de la liste ne peuvent pas l'être.

Voici quelques exemples :

• La valeur de liste '<blank>' est prise en charge. L'import d'une valeur vide pour une liste remplace toutes les valeurs par défaut, héritées et définies existantes dans la liste.
• La valeur de liste 'A,B,C' est prise en charge.
• La valeur de liste 'A,,C' n'est pas prise en charge.

Exécution d'opérations Copier et Modéliser d'après dans un fichier de chargement

Utilisez les colonnes Copy Node et Copy Action pour créer un noeud reposant sur la copie d'un noeud existant ou sur une modélisation d'après un noeud existant (dans un point de vue de hiérarchie) à l'aide d'un fichier de chargement de demande. (Pour plus de détails sur l'opération Modéliser d'après, reportez-vous à la section Ajout d'un noeud en effectuant une modélisation d'après un noeud existant.)

Remarques

• Les colonnes Copy Node et Copy Action sont utilisées dans les opérations Ajouter ou Mettre à jour uniquement. Si la colonne Action Code contient une autre opération, les colonnes Copy Node et Copy Action sont ignorées.
• Si la colonne Copy Node contient un noeud pour lequel un élément de demande existe déjà dans le fichier de chargement, les colonnes Copy Node et Copy Action de ce noeud sont ignorées.
• Si la propriété Core.Name pour le type de noeud d'un noeud ajouté via une opération Copier ou Modéliser d'après est configurée afin d'être calculée et stockée (reportez-vous à la section Propriétés calculées et stockées), le nom du nouveau noeud est calculé automatiquement.

Pour effectuer une opération Copier ou Modéliser d'après dans un fichier de chargement, procédez comme suit :

• Utilisez la colonne Copy Node pour indiquer le noeud à copier ou d'après lequel effectuer une modélisation.
• Utilisez la colonne Copy Action pour indiquer le type d'opération Copier. Spécifiez une de ces valeurs :
  • Properties : effectue une opération Copier pour le noeud indiqué dans la colonne Copy Node. L'opération Copier copie les valeurs de propriété définies au niveau du noeud et de la relation du noeud indiqué, et les inclut en tant qu'actions Mettre à jour pour l'élément de demande. (Il s'agit de la valeur par défaut si vous n'indiquez pas le type d'opération Copier.)
  • Model After (points de vue de hiérarchie uniquement) : effectue une opération Modéliser d'après pour le noeud indiqué dans la colonne Copy Node. L'opération Modéliser d'après effectue les actions suivantes :
    • Elle copie les relations de parenté du noeud indiqué et les inclut en tant qu'actions Insérer pour l'élément de demande.
    • Elle copie les valeurs de propriété définies au niveau de la relation pour chaque parent et les inclut en tant qu'actions Mettre à jour pour l'élément de demande.

Utilisation des sources de données dans les fichiers de chargement

Meilleures pratiques

Vous pouvez ajouter des éléments de demande provenant de plusieurs sources de données à un seul fichier de chargement, mais il est recommandé de créer un fichier de chargement distinct pour chaque source de données. Un élément de demande dans un fichier de chargement ne peut avoir qu'une seule source de données. Ainsi, si vous chargez un fichier de demande avec un noeud portant le même nom dans plusieurs sources de données, seule la première source de données du fichier est conservée. La création de fichiers de chargement distincts pour chaque source de données vous permet d'exécuter une mise en correspondance de ce noeud pour toutes les sources de données.

Colonne Data Source

Les éléments de demande dans le fichier de chargement sont mis à jour avec la source de données que vous indiquez dans la colonne Data Source (reportez-vous au chapitre Présentation des sources de données). Ils peuvent ainsi être liés aux noeuds existants dans le point de vue, ou mis en correspondance et fusionnés avec ces derniers (reportez-vous à la section Affichage des liens de noeud et au chapitre Mise en correspondance et fusion d'éléments de demande).

Remarques

• Vous pouvez utiliser le code ou le nom de la source de données pour identifier cette dernière dans le fichier de chargement. Il est recommandé d'utiliser le code de la source de données car le nom peut changer au fil du temps.
• Vous pouvez charger des noeuds à partir de sources de données enregistrées uniquement si le fichier de chargement a été initialement généré à partir de cette source de données enregistrée (par exemple, lors du rechargement d'un fichier de demande d'abonnement généré). Les lignes du fichier de chargement doivent contenir l'ID de noeud source et le type de noeud source générés à partir des sources de données enregistrées pour permettre le chargement.
• Si l'élément de demande fait déjà référence à une source de données différente de celle figurant sur la ligne, cette dernière est ignorée.

Noms de colonne réservée

Remarques

• Si une propriété a le même nom que celui d'une colonne réservée, vous pouvez utiliser un nom de colonne différent. Par exemple, si vous disposez d'une propriété nommée Data Source, vous pouvez utiliser un nom alternatif comme Data_Source, DataSource ou {Data Source}.

• Si la feuille de calcul est en cours de chargement dans un point de vue pour une liste, les colonnes et actions pour les hiérarchies sont ignorées. Par exemple, les actions de déplacement et d'insertion seraient ignorées dans un point de vue de liste.

Tableau 10-3 Codes d'action

Code d'action	Description
Add	Crée un noeud.
Delete	Supprime un noeud.
<Cellule vide>	Si la cellule Code d'action est vide, la ligne est traitée à l'aide du code d'action Mettre à jour.
Insert	Insère un noeud existant dans une hiérarchie sous le noeud indiqué par les cellules Parent et Parent Node Type.
Move	Déplace un noeud existant vers une nouvelle position dans une hiérarchie, enlevant le noeud de sa position existante.
Prop_Update	Met simplement à jour la valeur de propriété d'un noeud existant. Pour effectuer d'autres actions, utilisez le code d'action Update. Vous pouvez effacer la valeur d'une propriété définie. L'effacement de la valeur de propriété supprime la valeur stockée et rétablit la valeur par défaut ou héritée. Par exemple, l'action Prop_Update ci-après efface la valeur Description.
Rename	Change le nom d'un noeud existant.
Réorganiser	Réorganise un noeud dans un point de vue de hiérarchie. Vous pouvez réorganiser les noeuds uniquement dans un point de vue qui utilise un ensemble de hiérarchies permettant la réorganisation pour ce type de noeud (parent ou inférieur). Pour plus d'informations, reportez-vous à la section Réorganisation d'un noeud.
Remove	Enlève le noeud du noeud parent indiqué.
Update	Met à jour les valeurs de propriété d'un noeud existant. L'action Update effectue également des actions supplémentaires si la cellule dans une ligne indique que de telles actions sont requises. La liste suivante décrit son fonctionnement : Si le noeud n'existe pas, il est ajouté. Si le point de vue est hiérarchique, le noeud est inséré dans la position de la hiérarchie indiquée par les cellules Parent et Parent Node Type. Si le point de vue est hiérarchique et que le noeud existe mais qu'il n'est pas sous le parent indiqué, l'action résultante dépend de l'ensemble de hiérarchies, s'il autorise les noeuds partagés ou non : Si les noeuds partagés sont autorisés, le noeud est inséré sous le parent indiqué. Si les noeuds partagés ne sont pas autorisés, le noeud est déplacé sous le parent indiqué. Si la propriété l'autorise, vous pouvez mettre à jour une propriété avec une valeur vide. Vous devez utiliser l'indicateur <blank> dans la cellule, car une cellule vide ne produit pas les mêmes résultats. Par exemple, l'action de mise à jour ci-après définit la propriété Legal Entity sur une valeur vide. La description existante d'EMA ne change pas, même si la cellule de la description est vide.