Freigeben über

Ändern von EDI-Schemas

  • Artikel

Sie können ein vorhandenes EDI-Schema ändern, das in BizTalk Server ausgeliefert wird. Wenn Sie und Ihre Handelspartner Änderungen an Standardschemas vereinbart und möglicherweise die entsprechende MIG-Datei (Message Implementation Guideline) geändert haben, können Sie die Schemas im BizTalk-Editor in Visual Studio ändern.

Hinweis

Bei einigen Schemamodifikationen (feldübergreifende Überprüfung und Aufteilung von HIPAA-Unterdokumenten) kommt es zu Änderungen an den Anmerkungen in einem EDI-Schema. Diese Änderungen können nicht im BizTalk-Editor erfolgen, sondern müssen in einem Texteditor wie Editor vorgenommen werden.

Voraussetzungen

Sie müssen als ein Benutzer angemeldet sein, der zur BizTalk Server-Administratorengruppe gehört.

Schemabenennungskonvention

Ein EDI-Schema wird durch seinen Stammnamen und Namespace bestimmt. In einer BizTalk-Gruppe können Sie nicht zwei Schemas mit demselben Stammnamen und Namespace bereitstellen. Sie können den Stammnamen eines EDI-Schemas nicht ändern oder ergänzen, da der Stammname die Version und den Dokumenttyp gemäß einer Standardbenennungskonvention enthalten muss. Wenn Sie in derselben BizTalk-Gruppe zwei Schemas mit demselben Stammnamen bereitstellen möchten, müssen Sie für jedes einen anderen Namespace wählen.

Es kommt häufiger vor, dass ein Unternehmen in derselben BizTalk-Gruppe für zwei oder mehr Handelspartner eine andere Version desselben Schemas bereitstellt. In diesem Fall hätten die beiden Schemas dieselbe Version und denselben Dokumenttyp. Zum Bereitstellen dieser beiden Schemas benötigen Sie für jedes Schema unterschiedliche Namespaces.

EDI-Schemaänderungen

Sie können die folgenden Änderungen an einem EDI-Schema in Visual Studio vornehmen:

Gewünschte Formatierung Aktion
Ändern einer Enumeration

(z. B. der Werteliste in einer Codeliste)		 Öffnen Sie in den Eigenschaften für ein Element den Enumerations-Editor , und fügen Sie der Enumerationsliste einen Wert hinzu, oder löschen Sie einen Wert aus der Enumerationsliste.
Ändern der Optionalität eines Datenelements Ändern Sie die Eigenschaft Min Occurs . Ändern Sie sie in 0, um das Feld optional zu machen, oder in 1, um es verbindlich zu machen.
Ändern, wie oft ein Datenelement in der Datei maximal vorkommen darf Ändern Sie die Max Occurs-Eigenschaft .
Ändern der Anzahl der Zeichen im Datenelement Ändern Sie die Length-Eigenschaft .
Ändern des Datentyps eines Datenelements Ändern Sie die Eigenschaft Basisdatentyp oder Datumstyp .
Hinzufügen eines benutzerdefinierten Felds Fügen Sie einen Schemaknoten eines untergeordneten Feldelements ein, und legen Sie seine Eigenschaften fest. Hinweis: Das Hinzufügen eines untergeordneten Feldattributes zu einem Datensatz in einem EDI-Schema ist nicht zulässig, da die Sequenz der Elemente nicht garantiert wäre. Das Hinzufügen eines untergeordneten Feldattributs führt zu einem ungültigen Schema. Einem Datensatz in einem EDI-Schema können Sie nur ein untergeordnetes Feldelement hinzufügen.
Hinzufügen eines benutzerdefinierten Datensatzes Fügen Sie einen Schemaknoten eines untergeordneten Datensatzes ein, legen Sie seine Eigenschaften fest, und fügen Sie anschließend untergeordnete Feldelemente hinzu.
Löschen eines benutzerdefinierten Felds oder Datensatzes Löschen Sie ein benutzerdefiniertes Feld oder einen benutzerdefinierten Datensatz mit seinen untergeordneten Feldelementen.
Aktivieren der feldübergreifenden Gültigkeitsprüfung Legen Sie das Feldübergreifende Validierungsflag in der Anmerkung im Abschnitt appinfo des Schemas auf Ja fest. Dieses Flag ist entweder X12ConditionDesignator_Check (für X12- oder HIPAA-Schemas) oder EdifactDependencyRule_Check (für EDIFACT-Schemas).

Aktivieren Sie die feldübergreifende Gültigkeitsprüfung für ein bestimmtes Element, indem Sie die relationalen Bedingungen (X12 und HIPAA) oder Abhängigkeitsregeln (EDIFACT) angeben. Weitere Informationen finden Sie unter Konfigurieren der feldübergreifenden Validierung.

Außerdem müssen Sie die Edi-Typvalidierungseigenschaft auf ja festlegen.

Für HIPAA-Schemas ist die feldübergreifende Gültigkeitsprüfung standardmäßig aktiviert.
Aktivieren der Aufteilung von HIPAA-Unterdokumenten Legen Sie in einem der HIPAA-Schemas, in dem Sie die Unterdokumentaufteilung festlegen können, die eigenschaften subdocument_break und Split_Without_Sibling_Data für das Schema auf ja und die subdocument_creation_break-Eigenschaft für ein bestimmtes Element im Schema auf ja fest.

Außerdem müssen Sie die Option vereinbarung für die Batchverarbeitung für eingehenden Datenverkehr auf Austausch als Transaktionssätze aufteilen festlegen.

Weitere Informationen finden Sie unter Aufteilen von HIPAA-Unterdokumenten.
Hinzufügen von Triggerfeldern zu einem HIPAA-Dokument Sie können einrichten, dass der EDI-Disassembler für ein Segment in Ihrem HIPAA-Dokument basierend auf einem qualifizierenden Element, das als Triggerfeld bezeichnet wird, eindeutige XML-Datensätze generiert. Sie müssen die Attribute angeben, die das Segment und den Triggerwert beschreiben, damit für das Segment ein eindeutiger XML-Datensatz erstellt wird. Weitere Informationen finden Sie unter HIPAA-Schematriggerfeldanmerkungen.
Hinzufügen eines Segments zu einem X12-Transaktionssatz Wenn Sie einem X12-Transaktionssatz ein neues Segment hinzufügen, werden die ersten drei Zeichen des Segmentnamens als Segmentbezeichner verwendet. Es wird daher empfohlen, dass Sie ein Segment so benennen, dass die ersten drei Zeichen eindeutig sind.
Hinzufügen einer Schleife zu einem X12-Transaktionssatz Wenn Sie einem HIPAA-Transaktionssatz eine neue Schleife hinzufügen, empfiehlt es sich, die Schleife so zu benennen, dass „Loop“ (engl. Schleife) im Namen enthalten ist. Ein Beispielformat für eine Schleife ist „TS837_2010AB_Loop“. Hinweis: Das erste Segment in einer Schleife ist obligatorisch (minOccurs des Segments muss gleich 1 sein), um Mehrdeutigkeiten zu vermeiden.
Hinzufügen einer Schleife mit beliebiger Reihenfolge zu einem HIPAA-Transaktionssatz Wenn ein Transaktionssatz gleichwertige Segmente mit unterschiedliche Semantiken enthält, müssen Sie diese in einer Unterschleife (SubLoop) definieren. Ein SubLoop mit der XML-Anmerkung xs <:all> ermöglicht das Auftreten gleichwertiger Segmente in beliebiger Reihenfolge.

Sie sollten Schleifen mit beliebiger Reihenfolge so benennen, dass „SubLoop“ im Schleifennamen vorkommt. Ein Beispielformat ist "TS837Q1_2010A_SubLoop" Hinweis: Die Elemente einer beliebigen Order-Schleife dürfen nur einmal innerhalb der Schleife auftreten. Für die gleichgeordneten Elemente einer Unterschleife muss maxOccurs auf 1 festlegt werden, um Mehrdeutigkeiten zu vermeiden.

So ändern Sie ein vorhandenes EDI-Schema im BizTalk-Editor

  1. Fügen Sie in Visual Studio das Schema, das Sie ändern möchten, einem Projekt hinzu, und öffnen Sie das Schema im BizTalk-Editor.

    Hinweis

    Sie können das Schema in grafischer Form anzeigen, indem Sie unten im Schema-Editor auf die Registerkarte EDI klicken. In diesem Tabellenformat ist das Navigieren durch die Knoten des Schemas wesentlich einfacher.

  2. Klicken Sie zum Ändern der Eigenschaften eines Datenelements oder Datensatzes links im BizTalk-Editor auf den gewünschten Knoten, und ändern Sie seine Eigenschaften im Fenster Eigenschaften.

  3. Um die Werte in einer Enumeration zu ändern, wählen Sie die Enumeration im Bereich Eigenschaften aus, und klicken Sie dann auf die Auslassungspunkte, um den Enumerations-Editor zu öffnen. Fügen Sie der Liste der Werte nach Bedarf hinzu, oder löschen Sie diese, um sicherzustellen, dass in jeder Zeile im Bereich Werte ein Wert vorhanden ist. Klicken Sie auf OK.

  4. Klicken Sie zum Hinzufügen eines benutzerdefinierten Felds zum Schema mit der rechten Maustaste auf einen Datensatzknoten in der Konsolenstruktur des BizTalk-Editors, zeigen Sie auf Schemaknoten einfügen, und klicken Sie auf Untergeordnetes Feldelement. Benennen Sie das Datenelement, und ziehen Sie es an die gewünschte Position im Datensatz. Legen Sie die Eigenschaften des benutzerdefinierten Felds den Anforderungen entsprechend fest.

    Hinweis

    Das Hinzufügen eines untergeordneten Feldattributs zu einem Datensatz in einem EDI-Schema ist unzulässig, da dadurch die erforderliche Reihenfolge der Elemente ggf. nicht gewährleistet ist. Das Hinzufügen eines untergeordneten Feldattributs führt zu einem ungültigen Schema.

  5. Klicken Sie zum Hinzufügen eines benutzerdefinierten Datensatzes zum Schema mit der rechten Maustaste auf einen Datensatzknoten in der Konsolenstruktur des Schema-Editors, zeigen Sie auf Schemaknoten einfügen, und klicken Sie dann auf Untergeordneter Datensatz. Benennen Sie den Datensatz, und ziehen Sie ihn an die gewünschte Position im Schema. Fügen Sie dem Datensatz mindestens ein Datenelement hinzu. Legen Sie die Eigenschaften des benutzerdefinierten Datensatzes den Anforderungen entsprechend fest.

  6. Nachdem Sie die gewünschten Änderungen am Schema vorgenommen haben, können Sie den Zielnamespace ändern, der für die Schemaeigenschaft gilt, indem Sie auf den Stammknoten (<Schema>) klicken und dann die Eigenschaft Zielnamespace ändern.

  7. Speichern Sie das Schema.

  8. Überprüfen Sie das Schema, indem Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Schema klicken und auf Schema überprüfen klicken.

    Hinweis

    Der Befehl Schema überprüfen überprüft das EDI-Schema, da die Schema-Editor-Erweiterungseigenschaft des Stammknotens (<Schema>) auf EDI-Schema-Editor-Erweiterung festgelegt ist.

So ändern Sie die Anmerkungseigenschaften in einem vorhandenen EDI-Schema

  1. Öffnen Sie das Schema in einem Texteditor, z. B. in Editor.

  2. Gehen Sie zum Aktivieren der feldübergreifenden Überprüfung wie folgt vor. Weitere Informationen finden Sie unter Konfigurieren der feldübergreifenden Validierung.

    1. Legen Sie in der appinfo-Anmerkung oben im Schema das Feldübergreifende Validierungsflag (entweder X12ConditionDesignator_Check für X12 - oder HIPAA-Schemas oder EdifactDependencyRule_Check für EDIFACT-Schemas) auf Ja fest.

      Hinweis

      Das Feldübergreifende Validierungsflag ist standardmäßig Ja für BizTalk Server HIPAA-Schemas.

    2. Geben Sie in der Anmerkung für ein bestimmtes Element die relationalen Bedingungen (X12 und HIPAA) oder Abhängigkeitsregeln (EDIFACT) an. Weitere Informationen zu diesen Einstellungen finden Sie unter Cross Field-Segment Validation.

      Hinweis

      Stellen Sie auf der Seite Validierung (unter dem Abschnitt Transaktionssatzeinstellungen ) der Registerkarte Unidirektionale Vereinbarung des Dialogfelds Vereinbarungseigenschaften für die entsprechende Vereinbarung sicher, dass die Edi-Typüberprüfungseigenschaft ausgewählt ist.

  3. Gehen Sie zum Aktivieren der Aufteilung von HIPAA-Unterdokumenten wie folgt vor. Weitere Informationen finden Sie unter Aufteilen von HIPAA-Unterdokumenten.

    1. Legen Sie in der appinfo-Anmerkung oben im Schema die subdocument_break- und Split_Without_Sibling_Data-Flags auf ja fest.

    2. Sehen Sie sich in der Appinfo-Anmerkung für ein bestimmtes Element die subdocument_creation_break Flag auf ja an.

      Hinweis

      Stellen Sie auf der Seite Lokale Hosteinstellungen (im Abschnitt Austauscheinstellungen ) der Registerkarte One-Way Agreement des Dialogfelds Vereinbarungseigenschaften für die entsprechende Vereinbarung sicher, dass die Option Für die Verarbeitung eingehender Batchs auf Split Interchange as Transaction Sets festgelegt ist.

Weitere Informationen

Entwickeln von EDI-Schemas