Altova MapForce 2025 Enterprise Edition

Wenn eine unvollständige Validierung eines Felds nicht in Frage kommt oder unerwünscht ist, können Sie MapForce auch so konfigurieren, dass eine vollständige Feldvalidierung durchgeführt wird. Eine unvollständige Validierung könnte zu ungültigen Daten in der Ausgabe führen. Es empfiehlt sich daher, stattdessen eine vollständige Feldvalidierung durchzuführen. Zu diesem Zweck müssen Sie zusätzlich zu den bereits in MapForce verfügbaren .Codelist-Standarddateien benutzerdefinierte .Codelist-Dateien hinzufügen.

 

Mit Hilfe der benutzerdefinierten .Codelist-Dateien können Sie Codewerte, die in den EDI-Standards nicht definiert sind und somit in den MapForce-Konfigurationsdateien nicht vorhanden sind, hinzufügen. Dies gilt normalerweise für Codewerte, die in externen Standards und Recommendations definiert sind. In einer benutzerdefinierten .Codelist-Datei müssen alle in einem externen Standard definierten Codewerte vorhanden sein.

 

Vollständige Feldvalidierung des UN/EDIFACT-Datenelements 4405

Im nachstehenden Beispiel wird beschrieben, wie Sie die vollständige Feldvalidierung des UN/EDIFACT-Datenelements 4405, in dem externe Codewerte UN/ECE Recommendation 24 verwendet werden können, durchgeführt wird. Die Konfiguration erfolgt in zwei Teilen: (i) Erstellung der Struktur einer benutzerdefinierten .Codelist-Datei und (ii) Referenzierung der neuen .Codelist-Datei in den Konfigurationsdateien. Dieselbe Methode kann auch für andere EDI-Standards angewendet werden.

 

Erstellung einer benutzerdefinierten .Codelist-Datei

Um die Struktur einer benutzerdefinierten .Codelist-Datei zu erstellen, gehen Sie folgendermaßen vor:

 

1.Erstellen Sie eine benutzerdefinierte EDI-Collection. Sie können externe Codelisten zwar auch durch Bearbeitung der mit MapForce bereitgestellten .Codelist-Datei definieren, doch wird dies nicht empfohlen. Es empfiehlt sich, externe Codelisten immer in benutzerdefinierten Dateien zu definieren und Änderungen an den MapForce-Standardkonfigurationsdateien möglichst zu vermeiden.

2.Suchen Sie in Ihrem Verzeichnis für die benutzerdefinierte EDI-Collection nach der als Vorlage verwendeten .Codelist-Datei. In unserem Beispiel verwenden wir als Vorlage UNCL.Codelist.

3.Kopieren Sie UNCL.Codelist und geben Sie der Datei einen neuen Namen. Diese Datei wird von anderen MapForce-Konfigurationsdateien aus referenziert. In unserem Beispiel nennen wir die kopierte Datei UNECE24.Codelist.

4.Öffnen Sie UNECE24.Codelist in einem Editor (z.B. Altova XMLSpy) und löschen Sie den gesamten Inhalt des Elements <Codelist>.

5.Fügen Sie eine neue <Field>-Struktur für F4405 hinzu (siehe unten). Den korrekten Namen, die korrekte Länge und den korrekten Typ der einzelnen Felder finden Sie in der von MapForce bereitgestellten .Codelist-Standarddatei (in diesem Beispiel UNCL.Codelist).

 

<?xml version="1.0" encoding="UTF-8"?>
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="5" xsi:noNamespaceSchemaLocation="../EDIConfig5.xsd">  
  <Codelist>      
     <Field Name="F4405" Length="3" Type="Alphanumeric">
        <Title>Trade and transport status codes</Title>
        <Description>Code specifying a status.</Description>        
        <Values>

 
        <...>

 

        <Values>
     </Field>
  </Codelist>
</Config>

 

6.Fügen Sie für jeden externen Code ein neues <Value>-Element als Child des Elements <Values> hinzu, In diesem Beispiel fügen wir die ersten beiden in der UN/ECE Recommendation 24 definierten Codes hinzu.

 

<?xml version="1.0" encoding="UTF-8"?>
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="5" xsi:noNamespaceSchemaLocation="../EDIConfig5.xsd">  
  <Codelist>      
     <Field Name="F4405" Length="3" Type="Alphanumeric">
        <Title>Trade and transport status codes</Title>
        <Description>Code specifying a status.</Description>        
        <Values>
           <Value Code="1">
              <Title>Arrival, completed</Title>
              <Description>The goods/consignment/equipment/means of transport has arrived.</Description>
           </Value>
           <Value Code="2">
              <Title>Loading, authorized</Title>
              <Description>Authorization to load has been given.</Description>
           </Value>
        <Values>
     </Field>
  </Codelist>
</Config>

 

Referenzierung der benutzerdefinierten Datei

Die benutzerdefinierte Datei UNECE24.Codelist ist jetzt fertig definiert, aber noch nicht an MapForce gebunden. Damit MapForcer diese Datei erkennt, gehen Sie folgendermaßen vor:

 

1.Da das Datenelement 4405 keine unvollständige Validierung mehr aufweist, müssen Sie MapForce anweisen, eine vollständige Validierung durchzuführen: Entfernen Sie das Attribut Incomplete="1" für dieses Feld aus der Datei UNCL.Codelist oder setzen Sie den Wert dieses Attributs auf 0. Die zweite Option ist unten beschrieben:

 

<Field Name="F4405" Length="3" Type="Alphanumeric" Incomplete="0">
  <Title>Status description code</Title>
  <Description>Code specifying a status.</Description>
  <Note>1 For transport status, use UN/ECE Recommendation 24.</Note>

  <...>

</Field>

 

2.Referenzieren Sie UNECE24.Codelist in UNCL.Codelist (unten gelb markiert). Alternativ dazu können Sie Ihre benutzerdefinierte .Codelist-Datei in der Envelope.Config-Datei referenzieren.

 

<?xml version="1.0" encoding="UTF-8"?>
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="5" xsi:noNamespaceSchemaLocation="../EDIConfig5.xsd">
  <Include href="UNECE24.Codelist"/>
  <Codelist>

 

     <...>

 

  </Codelist>

 

In der obigen Anleitung wird beschrieben, wie Sie für alle Messages, in denen das Feld 4405 verwendet wird, eine globale Validierung durchführen. In einigen Fällen sollen die benutzerdefinierten Codelisten nur auf bestimmte Messages (d.h. lokal) angewendet werden. Nähere Informationen zur Verwendung der lokalen Methode finden Sie unter Validierung auf Message-Ebene.

 

© 2018-2024 Altova GmbH