Importation de documents XML et non XML personnalisés

Les documents XML 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, ces listes de codes sont disponibles dans la zone Données principales de l’application :

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs
  • CustomBODsOutToIONDesk

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.
    • Pour les documents XML, ce code est utilisé pour déterminer le type de document.
      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.
    • Pour les documents personnalisés qui ne sont pas au format XML, ce code est utilisé pour identifier ces propriétés :
      • Le message commence par - Les six premiers caractères permettant d'identifier le message
      • Standard de message - Le standard de message à associer au message
      • Type de message - Le type de message à associer au message
  • Créez un code pour la liste de codes CustomMessageIDs qui est utilisée dans le processus.
    • Pour les documents XML, ce code est utilisé pour déterminer l'expéditeur et le destinataire du document.
      • 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.

    • De même, pour les fichiers non XML, vous pouvez créer un code pour la liste de codes CustomMessageTypes afin de déterminer l'expéditeur et le destinataire du fichier.
      • Spécifiez un identifiant qui correspond au code CustomMessageTypes créé.
      • Sous l'onglet Valeurs 1, spécifiez les valeurs de la position 1 pour l'expéditeur et le destinataire. Lorsque le traitement démarre, la position 1 scanne le début du fichier non-XML pour s'assurer que les caractères correspondent au texte saisi dans la liste de codes. Ensuite, il utilise la numérotation à base unique pour trouver l'indice de début, qui est la position 2, et l'indice de fin, qui est la position 3, afin d'identifier l'expéditeur ou le destinataire.
  • 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é.
    • Il s'agit de la configuration requise pour les documents XML personnalisés :
      • 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 Standard de message, sélectionnez XML.
    • Il s'agit de la configuration requise pour les documents XML personnalisés :
      • 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 le nom du fichier de format.
        • Dans le champ Description de fichier de format cible, indiquez *none.
        • Dans le champ Standard de message, sélectionnez le standard non XML correspondant dans la liste déroulante (par exemple, sélectionnez Valeurs séparées par des virgules pour un fichier texte).
  • Créez un code pour la liste de codes CustomBODsOutToIONDesk et permettre l'envoi de BOD sortants personnalisés de ION Connector vers ION Desk
    Remarque

    Cette liste de codes doit suivre un format de type Verb.Noun. Dans la boîte de dialogue Gérer les propriétés de code, un exemple de valeur dans le champ Identificateur est Process PurchaseOrder. Le champ Description fournit une description du BOD personnalisé.

Configuration de la 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. Corrigez toutes les valeurs requises pour le traitement.