Importation de documents XML personnalisés

Les documents XML personnalisés peuvent être transformés dans l'application grâce à l'utilisation de listes de codes. Pour permettre la mise en œuvre d'un traitement personnalisé des documents XML, ces listes de codes sont disponibles dans la zone Données principales de l’application :

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs

Configuration requise

Voici les étapes préalables à la configuration de cette fonctionnalité :

  • Créer une feuille de style personnalisée avec un document XML associé.
  • Déterminez les valeurs souhaitées pour le partenaire commercial, s'il ne s'agit pas d'un partenaire commercial standard.

Configuration

Voici les exigences de configuration dans le domaine des données de base :

  • Créez un code pour la liste de codes CustomTradingPartner qui est utilisée dans le processus.
  • Créez un code pour la liste de codes CustomMessageTypes qui est utilisée dans le processus. Cette valeur est utilisée pour les listes déroulantes permettant de sélectionner les types de messages standard. Dans le tableau des propriétés de liste de codes, créez un code avec l'identifiant correspondant au type de document défini dans le document XML personnalisé.
  • Créez un code pour la liste de codes CustomMessageFormats qui est utilisée dans le processus. Ce code est utilisé pour déterminer le type du document XML.
    Remarque

    Le processus passe en revue tous les formats de messages personnalisés pour trouver un type de document. Il utilise le premier format de message personnalisé dans lequel une valeur correspondant à l'élément spécifié est trouvée.

    • Dans la boîte de dialogue Gérer les propriétés de code, vous devez définir une valeur unique dans le champ Identificateur.
    • Réglez le champ Élément type de message dans l'onglet Valeurs 1 sur l'élément du document XML personnalisé qui détermine le type de document XML. Seule la première instance de cet élément est utilisée dans le processus. Les éléments XML sont pris en charge ; en revanche, les attributs ne le sont pas.
  • Créez un code pour la liste de codes CustomMessageIDs qui est utilisée dans le processus. Ce code est utilisé pour déterminer l'expéditeur et le destinataire du document XML.
    • Spécifiez un identifiant qui correspond au code CustomMessageTypes créé.
    • Dans l'onglet Valeurs 1, vous devez spécifier, au minimum, l' ID émetteur position 1 et l' ID récepteur position 1. Ces valeurs sont des éléments XML. Le processus commence à l'emplacement de la première instance de la position 1. Si la position 2 est spécifiée, il passe à la position 2. Si la position 3 est spécifiée, il passe à la position 3. Lorsqu'une position est spécifiée, elle doit exister dans le document ; sinon, le traitement ne peut pas aboutir.
      Remarque

      Il n'est pas nécessaire que la première position soit l'élément du document.

  • Créez un code pour la liste de codes CustomStyleSheetRules qui est utilisée dans le processus. Ce code est utilisé pour déterminer la feuille de style utilisée pour transformer le document XML personnalisé.
    • Dans la boîte de dialogue Gérer les propriétés de code, spécifiez un identifiant qui est utilisé pendant le traitement et affiché dans les recherches et les listes déroulantes. Cette valeur est généralement le nom du fichier de la feuille de style sans extension de fichier.
    • Dans l'onglet Valeurs 1, indiquez les valeurs de ces champs :
      • Spécifiez le nom du fichier dans le champ Nom du fichier de la feuille de style qui est utilisé pour la transformation. Le nom du fichier doit inclure l'extension du fichier.
      • Dans le champ Description de fichier de format source, indiquez *none.
      • Dans le champ Description de fichier de format cible, indiquez *none.
      • Dans le champ Message Standard, sélectionnez XML.

Configuration de Transformation

Voici les étapes à suivre pour configurer l'ID du partenaire :

  1. Sélectionnez Transformation > Configuration > ID de partenaires.
  2. Cliquez sur Créer.
  3. Depuis la page ID du partenaire, sélectionnez le type de message personnalisé dans la liste déroulante Type de message.
  4. Sélectionnez le partenaire commercial dans la liste déroulante Partenaire commercial.
  5. Dans la section ID d’expéditeur/destinataire, spécifiez un ID d'expéditeur et un ID de destinataire dans les champs respectifs.
  6. Dans la section Mappage de partenaire interne/externe, spécifiez les valeurs dans les champs de mappage.

Voici les étapes de la configuration de la règle de transformation :

  1. Sélectionnez Transformation > Configuration > Règles de transformation.
  2. Cliquez sur Créer pour créer la règle de transformation.
  3. Depuis la page Règles de transformation, sélectionnez le partenaire commercial personnalisé, le type de message personnalisé et la règle de feuille de style personnalisée dans les champs correspondants.

Voici les étapes de la configuration de la feuille de style personnalisée :

  1. Sélectionnez Transformation > Configuration > Feuilles de style.
  2. Cliquez sur Créer pour créer l'enregistrement de la feuille de style personnalisée.
  3. Depuis la page Feuilles de style, utilisez le partenaire commercial personnalisé et le nom de la feuille de style, y compris l'extension de fichier, qui ont été créés pour la règle de feuille de style personnalisée.

Traitement des documents XML personnalisés

Voici les étapes du traitement des documents XML personnalisés :

  1. Sélectionnez Transformation > Importer messages pour importer le document XML. Ou, si la configuration client sur site a été mise en œuvre dans la zone Communications, importez le document XML via Exchange Services.
    Remarque

    Pour l'instant, ION Connector n'est pas pris en charge.

  2. Sélectionnez Transformation > Gérer les messages.
  3. Depuis la page Gérer les messages, vérifiez les résultats. Fixez toutes les valeurs requises pour le traitement.