Aangepaste XML- en niet-XML-documenten importeren

Aangepaste documenten kunnen in de applicatie worden getransformeerd met behulp van codelijsten. Om de verwerking van aangepaste documenten mogelijk te maken, zijn de volgende codelijsten beschikbaar in het gedeelte Basisgegevens van de applicatie:

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs
  • CustomBODsOutToIONDesk

Vereisten

De volgende stappen zijn vereist voordat u deze functionaliteit configureert:

  • Maak een aangepast opmaakmodel aan met een gekoppeld XML-document.
  • Bepaal de gewenste waarden voor de handelspartner wanneer het geen standaard handelspartner betreft.

Instellingen

De volgende instellingen zijn vereist in het gebied Basisgegevens:

  • Maak een code aan voor de codelijst CustomTradingPartner die in het proces wordt gebruikt.
  • Maak een code aan voor de codelijst CustomMessageTypes die in het proces wordt gebruikt. Deze waarde wordt gebruikt voor vervolgkeuzemenu's voor het selecteren van standaard berichttypen. Maak in de tabel Eigenschappen codelijst een code aan met de ID die overeenkomt met het documenttype dat in het aangepaste XML-document is gedefinieerd.
  • Maak een code aan voor de codelijst CustomMessageFormats die in het proces wordt gebruikt.
    • Bij XML-documenten wordt deze code gebruikt om het documenttype te bepalen.
      NB

      Het proces doorloopt alle aangepaste berichtindelingen om een documenttype te vinden. De eerste aangepaste berichtindeling waarin een waarde wordt gevonden bij het opgegeven element, wordt gebruikt.

      • In het dialoogvenster Eigenschappen code beheren moet u een unieke waarde instellen in het veld ID.
      • Stel het veld Element berichttype op het tabblad Waarden 1 in op het element in het aangepaste XML-document dat het XML-documenttype bepaalt. Alleen het eerste exemplaar van dit element wordt gebruikt in het proces. XML-elementen worden ondersteund, maar kenmerken worden niet ondersteund.
    • Bij aangepaste documenten die geen XML-indeling hebben, wordt deze code gebruikt om de volgende eigenschappen te identificeren:
      • Bericht begint met - De eerste zes tekens om het bericht te identificeren
      • Berichtstandaard - De berichtstandaard die aan het bericht wordt gekoppeld
      • Berichttype - Het berichttype dat aan het bericht wordt gekoppeld
  • Maak een code aan voor de codelijst CustomMessageIDs die in het proces wordt gebruikt.
    • Bij een XML-document wordt deze code gebruikt om de afzender en de ontvanger van het document te bepalen.
      • Geef een ID op die overeenkomt met de aangemaakte CustomMessageTypes-code.
      • Op het tabblad Waarden 1 moet u ten minste Positie 1 afzender-ID en Positie 1 ontvanger-ID opgeven. Deze waarden zijn XML-elementen. De verwerking begint op de locatie van het eerste exemplaar van positie 1. Als positie 2 is opgegeven, gaat de verwerking verder naar positie 2. Als positie 3 is opgegeven, gaat de verwerking verder naar positie 3. Er kunnen alleen posities worden opgegeven die bestaan in het document, anders kan de bewerking niet worden uitgevoerd.
        NB

        De eerste positie hoeft niet het documentelement te zijn.

    • Ook voor niet-XML-bestanden kunt u een code voor de codelijst CustomMessageTypes aanmaken om de afzender en ontvanger van het bestand te bepalen.
      • Geef een ID op die overeenkomt met de aangemaakte CustomMessageTypes-code.
      • Geef op het tabblad Waarden 1 de waarden voor positie 1 op voor de afzender en de ontvanger. Als de verwerking begint, scant positie 1 het begin van het niet-XML-bestand om te controleren of de tekens overeenkomen met de tekst die is ingevoerd in de codelijst. Vervolgens wordt op één gebaseerde nummering gebruikt om de beginindex (positie 2) en eindindex (positie 3) te vinden om de afzender of ontvanger te identificeren.
  • Maak een code aan voor de codelijst CustomStyleSheetRules die in het proces wordt gebruikt. Deze code wordt gebruikt om te bepalen welk opmaakmodel wordt gebruikt om het aangepaste document te transformeren.
    • Dit zijn de vereiste instellingen voor aangepaste XML-documenten:
      • Geef in het dialoogvenster Eigenschappen code beheren een ID op die wordt gebruikt tijdens de verwerking en in zoekvelden en vervolgkeuzelijsten wordt weergegeven. Deze waarde is meestal de bestandsnaam van het opmaakmodel zonder bestandsextensie.
      • Geef op het tabblad Waarden 1 de volgende veldwaarden op:
        • Geef de bestandsnaam op in het veld Bestandsnaam van opmaakmodel dat wordt gebruikt voor de transformatie. De bestandsnaam moet de bestandsextensie bevatten.
        • Geef in het veld Source Format File Description (bron-FFD) *none op.
        • Geef in het veld Target Format File Description (doel-FFD) *none op.
        • Selecteer in het veld Berichtstandaard XML.
    • Dit zijn de vereiste instellingen voor aangepaste niet-XML-documenten:
      • Geef in het dialoogvenster Eigenschappen code beheren een ID op die wordt gebruikt tijdens de verwerking en in zoekvelden en vervolgkeuzelijsten wordt weergegeven. Deze waarde is meestal de bestandsnaam van het opmaakmodel zonder bestandsextensie.
      • Geef op het tabblad Waarden 1 de volgende veldwaarden op:
        • Geef de bestandsnaam op in het veld Bestandsnaam van opmaakmodel dat wordt gebruikt voor de transformatie. De bestandsnaam moet de bestandsextensie bevatten.
        • Geef in het veld Source Format File Description (bron-FFD) de naam van het indelingsbestand op.
        • Geef in het veld Target Format File Description (doel-FFD) *none op.
        • Selecteer in het veld Berichtstandaard de gewenste niet-XML-standaard in de vervolgkeuzelijst (selecteer bijvoorbeeld Door komma's gescheiden waarden voor een tekstbestand).
  • Maak een code aan voor de codelijst CustomBODsOutToIONDesk om toe te staan dat aangepaste uitgaande BOD's van ION-connector naar ION Desk worden verzonden.
    NB

    Voor deze codelijst moet de indeling Verb.Noun worden gebruikt. In het dialoogvenster Eigenschappen code beheren kan het veld ID bijvoorbeeld de waarde Inkooporder verwerken bevatten en kan het veld Omschrijving een omschrijving van het aangepaste BOD bevatten.

Instellingen voor transformatie

Voer de volgende stappen uit om de partner-ID in te stellen:

  1. Selecteer Transformatie > Configuratie > Partner-ID's.
  2. Klik op Aanmaken.
  3. Selecteer op de pagina Partner-ID het aangepaste berichttype in de vervolgkeuzelijst Berichttype.
  4. Selecteer de handelspartner in de vervolgkeuzelijst Handelspartner.
  5. Geef in de sectie ID's afzender/ontvanger een afzender-ID en een ontvanger-ID op in de betreffende velden.
  6. Geef in de sectie Interne/externe partnertoewijzing de waarden op in de toewijzingsvelden.

Voer de volgende stappen uit om de transformatieregel in te stellen:

  1. Selecteer Transformatie > Configuratie > Transformatieregels.
  2. Klik op Aanmaken om de transformatieregel aan te maken.
  3. Selecteer op de pagina Transformatieregels de aangepaste handelspartner, het aangepaste berichttype en de regel van het aangepaste opmaakmodel in de betreffende velden.

Voer de volgende stappen uit om het aangepaste opmaakmodel in te stellen:

  1. Selecteer Transformatie > Configuratie > Opmaakmodellen.
  2. Klik op Aanmaken om de record met het aangepaste opmaakmodel aan te maken.
  3. Gebruik op de pagina Opmaakmodellen de aangepaste handelspartner en de naam van het opmaakmodel met de bestandsextensie die zijn aangemaakt voor de regel van het aangepaste opmaakmodel.

Aangepaste XML-documenten verwerken

Voer de volgende stappen uit om aangepaste XML-documenten te verwerken:

  1. Selecteer Transformatie > Berichten importeren om het XML-document te importeren. In het geval dat de Clientconfiguratie on-premise is geïmplementeerd in het gebied Communicatie, importeert u het XML-document via Exchange Services.
    NB

    Op dit moment wordt ION-connector niet ondersteund.

  2. Selecteer Transformatie > Berichten beheren.
  3. Controleer de resultaten op de pagina Berichten beheren. Corrigeer eventuele waarden die zijn vereist voor de verwerking.