Format de fichier d'import et d'export pour les dimensions définies par l'utilisateur

Lorsque vous importez et exportez des données pour des dimensions définies par l'utilisateur, vous devez utiliser un fichier valeurs séparées par des virgules (.csv).

La liste suivante décrit le format ainsi que d'autres éléments à prendre en compte concernant les fichiers d'import et d'export :

  • Le fichier doit comporter les colonnes suivantes :
    • Nom : nom du noeud.
    • Parent. Nom du noeud parent, si la dimension est une hiérarchie. Si le noeud n'a pas de noeud parent, ce champ doit être vide.

    Remarque :

    Par défaut, la valeur de l'en-tête de colonne Nom est Noeud. Les en-têtes de colonne Nom et Parent peuvent être personnalisés lors de l'enregistrement.

  • Si la dimension a des propriétés, le fichier contient une colonne pour chacune d'entre elles. L'en-tête de colonne est la valeur indiquée lors de la création de la propriété. Pour en savoir plus, reportez-vous à Ajout d'une propriété existante à un type de noeud pour une dimension définie par l'utilisateur et à Création d'une propriété personnalisée.
  • Vous pouvez créer, modifier et supprimer des colonnes de constante dans le fichier d'export. Reportez-vous à la section Gestion des clés de constante pour les applications universelles dans Modification des clés de liaison.
  • La configuration de la dimension détermine s'il existe des colonnes pour les types de noeud ainsi que la manière dont les noeuds supérieurs sont indiqués. Pour en savoir plus, reportez-vous à Paramètres d'import et d'export d'une dimension définie par l'utilisateur.
  • Les données sont importées dans l'ordre des lignes. Les lignes pour les noeuds parent doivent précéder celles pour les noeuds enfant. Si une ligne pour un noeud enfant précède la ligne de son noeud parent, une erreur survient lors de l'import du fichier.
  • L'ordre dans lequel vous placez les colonnes dans le fichier d'import n'est pas important.
  • Si un en-tête de colonne ne correspond pas aux indications décrites ci-dessus, l'import ignore la colonne.

    Conseil :

    Un fichier d'import peut donc contenir des informations qui ne seront pas importées. Par exemple, un fichier d'import peut contenir une colonne destinée aux commentaires.
  • L'import ignore les lignes en double.
  • Les chaînes du fichier contenant un caractère séparateur, un guillemet ou un caractère de fin de ligne (CR/LF) ou commençant par les caractères ASCII 35 et inférieurs (par exemple, Tab, ! ou #) seront placées entre guillemets. (Par exemple, "# Children", "Accumulated Depreciation, Equipment".)

  • 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 Java, reportez-vous à Utilisation de formats prédéfinis.

Exemple 37-1 Fichier d'import pour une dimension

Supposons que vous avez défini une dimension Departments comme suit :

  • Elle contient deux types de noeud, qui sont nommés Department et Department Rollup.
  • Les deux types de noeud utilisent la propriété Description.
  • Le type de noeud Department Rollup a une propriété nommée Company, qui a été configurée pour utiliser l'abréviation CO en tant qu'en-tête de colonne.
  • La dimension a été configurée avec les paramètres d'import et d'export suivants :
    • TOPNODE représente les noeuds supérieurs.
    • Les fichiers peuvent disposer d'une colonne pour les types de noeud. L'en-tête de colonne est Type de noeud.
    • Les fichiers peuvent disposer d'une colonne pour les types de noeud parent. L'en-tête de colonne est Type de noeud parent.
    • Si le fichier d'import ne contient pas les colonnes Type de noeud et Type de noeud parent, les imports affecteront des noeuds inférieurs au type de noeud Department et des noeuds parent au type de noeud Department Rollup.

    Paramètres de dimension décrits dans la liste précédente.

Le tableau suivant présente les premières lignes d'un fichier d'import pour la dimension de l'exemple :

Nom Description Type de noeud Parent Type de noeud parent CO
TD Total Department Department Rollup TOPNODE   1
100 Ressources Department TD Department Rollup  
110 Facilities Resources Department 100 Department  
111 West Region Resources Department 100 Department  

Remarque :

La valeur TOPNODE de la colonne Parent indique que TD est le noeud racine. L'en-tête de colonne pour la propriété Company est CO.