Importation et exportation pour les définitions de structures de données M3

Ce document décrit l’importation et l’exportation des définitions de structure de données dans M3.

Avec l’importation et l’exportation des définitions de structure de données M3, vous pouvez importer et exporter des définitions de structure de données M3 depuis une société ou un locataire vers un autre. Vous pouvez exporter des définitions de structures de données au format XML depuis ces programmes et les importer dans la base de données M3 via des API et des programmes de fonction.

  • 'Struct données. Ouvrir' (OSS401)
  • 'Struct données. Connecter champs cumul' (OSS402)
  • 'Struct données. Connecter champs sélect' (OSS403)
  • 'Struct donn. Connecter valeurs de champ' (OSS404)
  • 'Struct données. Connecter types trans SD' (OSS406)
  • 'Budget de ventes. Ouvrir' (OSS420)

Le fichier des éléments de configuration prend en charge les stratégies d’importation 'Remplacer les enregistrements existants' et 'Conserver les enregistrements existants' dans l’outil de données de configuration de Business Engine. Vous pouvez exporter jusqu’à 200 enregistrements dans (OSS401) en une seule fois.

Restrictions

  • L’activation d’une structure de données dans (OSS401), le budget des ventes dans (OSS420) et la mise à jour d’une version de budget dans (OSS401) ne sont prises en charge que lors de 'Remplacer les enregistrements existants'.
  • Pendant l’importation, si le fichier XML contient des enregistrements dans (OSS402), (OSS403), (OSS404), (OSS406) ou (OSS420) qui n’existent pas dans la division cible, ces enregistrements sont ajoutés quelle que soit l’option sélectionnée ('Conserver les enregistrements existants' ou 'Remplacer les enregistrements existants'). Par exemple, vous importez une structure de données dans la division B avec ces enregistrements, ceux-ci sont supprimés de la structure de données après importation dans la division B. Si pour une raison quelconque, cette structure de données est réimportée avec ces enregistrements qui ont été supprimés dans la division B, ils sont ajoutés indépendamment de l’option 'Conserver les enregistrements existants' ou 'Remplacer les enregistrements existants'.
  • Les enregistrements de la table des structures de données ne font pas partie de l’exportation et de l’importation.

Avant de commencer

Vous devez créer une structure de données. (Voir la fonction de support dans Exportation de données d'une structure de données vers un fichier)

Suivez les étapes ci-dessous :

  1. Exporter la structure de données.

    Vous pouvez le faire de deux manières.

    Sélection de structure de données

    • Ouvrez (OSS401) et sélectionnez une structure de données.
    • Sélectionnez l’option associée 21 (Exporter configuration) dans la structure de données à exporter. La fenêtre Exporter la configuration s’affiche.
    • Saisissez un nom de fichier dans le champ 'Nom de fichier' ou laissez le champ par défaut spécifié. Ce champ est obligatoire.
    • Saisissez le numéro de version du fichier dans le champ 'Version'. Ce champ est obligatoire.
    • Saisissez la description du fichier dans le champ 'Description'. Ce champ est facultatif.
    • Saisissez la description de la dépendance de fichier dans le champ 'Desc dépendance'. Ce champ est facultatif.
    • Cliquez sur OK pour exporter le fichier.

    Plage de structures de données

    • Ouvrez (OSS401) et sélectionnez une structure de données.
    • Spécifiez une plage de données en sélectionnant F17 (Exporter). L'écran S s'affiche.
    • Saisissez la plage de données à exporter dans les champs 'Début' et 'Fin'.
    • Saisissez un nom de fichier dans le champ 'Nom de fichier' ou laissez le champ par défaut spécifié. Ce champ est obligatoire.
    • Saisissez le numéro de version du fichier dans le champ 'Version'. Ce champ est obligatoire.
    • Saisissez la description du fichier dans le champ 'Description'. Ce champ est facultatif.
    • Saisissez la description de la dépendance de fichier dans le champ 'Desc dépendance'. Ce champ est facultatif.
    • Cliquez sur OK pour exporter le fichier.

    Le fichier est exporté au format XML. Le fichier est enregistré sur le disque de transfert de fichiers M3 dans le répertoire FileImport après exportation. Pour voir le fichier, accédez aux fichiers M3 Business Engine dans le menu Outils d’administration.

  2. Importer une structure de données.

    Vous pouvez effectuer l’importation dans les outils d’administration M3 BE.

    Les fichiers sources doivent être placés sur le disque de transfert de fichiers M3 (M3 File Transfer), dans le répertoire FileImport. Pour ce faire, utilisez l'application Fichiers M3 Business Engine dans le menu Outils d'administration.

    • Dans (H5), sélectionnez le menu d'application. Dans le menu développé, accédez aux Outils d'administration.
    • Sélectionnez 'Business Engine Configuration Data'.
    • Sélectionnez l'onglet 'Exporté' pour afficher une liste de tous les fichiers XML d'exportation.
    • Recherchez le fichier XML exporté en recherchant le nom d’un fichier.
    • Sélectionnez le fichier XML et cliquez sur 'Importer'.

    • La fenêtre Données de configuration d’importation s’affiche. Saisissez la division et la société dans lesquelles importer. Sélectionnez l’option 'Conserver les enregistrements existants' si vous souhaitez conserver la structure de données existante ou 'Remplacer les enregistrements existants' si vous souhaitez remplacer la structure de données existante. Sélectionnez Log to file (Enregistrer dans un fichier) pour afficher les journaux après l’importation. Ceci est important en cas d’échec de l’importation. Les journaux affichent la raison pour laquelle l’importation a échoué.

      Un message s’affiche si l’importation a réussi ou non.

    L'outil d'importation lit le fichier XML et exécute les programmes API requis pour écrire les données dans la base de données M3 BE. Le programme et la transaction API à exécuter sont spécifiés dans le fichier XML. Si les données doivent être remplacées, une transaction de suppression (Delete) est exécutée avant la transaction d'ajout (Add)

Rubriques liées