Import d'artefacts sélectif et ordonné

Vous pouvez contrôler l'import des artefacts Essbase à l'aide d'un fichier texte de liste de sélection, pour les migrations sur site (avec l'outil autonome LCM) et de service cloud (avec l'outil CLI).

Un fichier texte de liste de sélection contient la liste de tous les artefacts du fichier ZIP exporté, groupés par section. Vous pouvez générer le fichier pendant l'export, à l'aide de la commande lcmexport. Une section IMPORT figure à la fin du fichier. Elle contient la liste des entrées d'artefact à importer.

Vous pouvez modifier le fichier et supprimer, ou commenter, les lignes d'artefacts à ignorer lors de l'import, à l'aide de la commande lcmimport. Vous indiquez le fichier texte en tant qu'argument dans l'opération lcmimport. Vous pouvez également contrôler l'ordre de l'import.

Exemple de fichier texte de liste de sélection

@Provisions
/Sample/Provisions/CalcAssociation.csv

@Databases/Basic/Calc_scripts
/Sample/Databases/Basic/Calc scripts/Default Calc
/Sample/Databases/Basic/Calc scripts/CalcAll.csc

# ------------IMPORT-----------------
import @Provisions
import @Databases/Basic/Calc_scripts
# ------------IMPORT----------------

Procédure d'utilisation de cette fonction

  • Pendant l'export avec l'outil CLI, vous pouvez indiquer l'argument facultatif -gal, –generateartifactlist dans la commande lcmexport pour générer un fichier texte contenant la liste des artefacts exportés.
  • Pour ignorer toute une catégorie de fichiers, par exemple les fichiers .rul, commentez la section IMPORT correspondante à la fin du fichier texte.
  • Pour ignorer des fichiers spécifiques, supprimez ou commentez les entrées correspondantes dans le fichier texte.
  • Pour contrôler l'ordre d'import, réorganisez les entrées de n'importe quelle catégorie spécifique dans l'ordre souhaité pour l'import. Les fichiers sont alors importés dans l'ordre indiqué dans la catégorie. Pendant l'import, indiquez ce fichier avec -al, -artifactlist.
  • La commande lcmimport comporte une option -overwrite.
    • Si l'option -overwrite est définie sur True, l'opération d'import recrée l'ensemble de l'application. Seuls les artefacts ou fichiers répertoriés dans le fichier texte sont importés.
    • Si l'option -overwrite est définie sur False, l'opération d'import importe seulement les artefacts ou fichiers qui ne sont pas commentés dans le fichier texte. L'opération n'affecte pas les autres artefacts figurant déjà dans l'application cible.

Exemples de cas d'emploi

  • Import des données du fichier ZIP exporté uniquement

    Vous disposez d'un fichier ZIP exporté de l'application Sample et ne souhaitez importer que les données de Sample/Basic.

    • Dans le fichier texte généré pendant l'opération lcmexport, commentez toutes les entrées d'import, sauf "import @Databases/Basic".
    • Commentez également "/Sample/Databases/Basic/Basic outline" sous "@Databases/Basic", pour n'importer que les données.
    • L'option -overwrite n'est pas valide dans ce cas d'emploi (import de type "données uniquement"). En effet, lors de l'import, LCM supprimera l'ensemble de l'application et l'importera comme vide. La tentative d'import concerne ensuite seulement des données, sans l'outline. L'application n'est donc plus valide.
  • Import de l'outline uniquement

    Vous voulez mettre à jour le cube Sample.Basic avec uniquement l'outline du fichier ZIP exporté.

    • Dans la section IMPORT à la fin du fichier texte, commentez toutes les entrées sauf "import @Databases/Basic".
    • Commentez également "/Sample/Databases/Basic/Data" sous "@Databases/Basic", pour n'importer que l'outline.
  • Import d'un cube unique pour une application en comportant plusieurs

    L'application Sample comporte trois cubes nommés Basic, Basic1 et Basic2. Vous ne voulez importer que Basic.

    • Dans la section IMPORT à la fin du fichier texte, commentez toutes les entrées sauf le cube "Basic" (import @Databases/Basic, import @Databases/Basic/Xml_files, etc.).
    • Si l'option -overwrite n'est pas utilisée, l'opération importe ou remplace seulement le cube Basic. Les autres cubes (Basic1, Basic2) de l'application restent tels quels.
    • Si l'option -overwrite est utilisée, l'opération supprime et recrée l'application, avec seulement le cube Basic.