Anpassen von Enumerationen im Umschlagschema
mit BizTalk Server können Sie ID-Feldaufzählungen im Dienstschema (Umschlag) anpassen. Dies wiederum ermöglicht das Empfangen und Senden von Austauschelementen, die in den ID-Feldern für Absender oder Empfänger im Umschlag keine Standardwerte besitzen (Werte, die außerhalb des durch die X12-Standards definierten Wertesatzes liegen). Ferner ermöglicht es Ihnen das Ändern der Qualifizierer, die in den Dropdownlisten für Headerwerte in Definitionen von Vereinbarungseigenschaften verfügbar sind.
Wichtig
Wenn Sie ein Schema ändern, gelten diese Änderungen für alle Transaktionen gemäß dem fraglichen Standard. Sie können keine Änderungen am Umschlagschema für eine einzelne Partei vornehmen.
BizTalk Server ruft die Liste der zulässigen Werte aus statischen Dienstschemas in der Microsoft.BizTalk.Edi.BaseArtifacts.dll ab, die im Lieferumfang des Produkts enthalten ist. Um den Basissatz von Werten zu erweitern, müssen Sie eine Dienstschemaerweiterung entwickeln und bereitstellen. BizTalk Server stellt Dienstschemavorlagen (Umschlag) bereit, die Sie verwenden können, um die Enumerationen in zu ändern. Diese Dienstschemas befinden sich in den Dateien X12_ServiceSchemaExtension.xsd und EDIFACT_ServiceSchemaExtension.xsd. Jedes benutzerdefinierte Schema besitzt einen der folgenden Namespaces, basierend auf dem Standard. Dieser Namespace kann nicht geändert werden.
| Standard | Namespace |
|---|---|
| X12 und HIPAA | http://schemas.microsoft.com/BizTalk/EDI/X12/2006 |
| EDIFACT | http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006 |
Sie nehmen die Änderungen am Schema im BizTalk-Editor in Visual Studio vor (siehe verfahren unten). Nach Vornahme der erforderlichen Änderungen müssen Sie das Schema bereitstellen.
Wenn BizTalk Server sowohl auf der Empfangs- als auch auf der Sendeseite die Umschlagsegmente (ISA und GS für X12 oder UNB und UNG für EDIFACT) überprüft, wird das Vorhandensein des benutzerdefinierten Dienstschemas basierend auf seinem Namespace überprüft. Wenn das benutzerdefinierte Schema bereitgestellt wird, führt BizTalk Server dieses Schema mit dem regulären Dienstschema zusammen und verwendet, sofern angegeben, sowohl benutzerdefinierte als auch Standardenumerationswerte. Sie können das Schema so anpassen, dass eine Enumerationsliste erweitert wird, können aber keine Werte daraus entfernen. Wenn kein benutzerdefiniertes Schema bereitgestellt wird, verwenden BizTalk Server das Standarddienstschema.
Nachdem Sie ein benutzerdefiniertes Schema bereitgestellt haben, verwendet die Tpm-Benutzeroberfläche (Trading Partner Management) in der BizTalk Server-Verwaltungskonsole die Werte in einer benutzerdefinierten Enumeration, um die entsprechenden Dropdownlisten auf den TPM-Eigenschaftenseiten aufzufüllen. Wenn Sie kein benutzerdefiniertes Schema bereitgestellt haben, verwendet TPM die Werte in den Enumerationen im Standarddienstschema. Darüber hinaus verwendet die BizTalk Server Runtime die benutzerdefinierte Enumeration, um eine Nachricht zu überprüfen.
Wenn Sie die mit BizTalk Server bereitgestellten XML-Tools verwenden, um einen instance mit seinem Umschlag zu überprüfen, und Sie das Dienstschema angepasst haben, müssen Sie das benutzerdefinierte Dienstschema in das BizTalk-Projekt aufnehmen, zusätzlich zu den Dokumentschemas (Transaktionssatzschemas) und ggf. dem Batchschema. Dies ist nicht erforderlich, wenn Sie eine Transaktionssatzinstanz überprüfen, die keinen Umschlag besitzt.
Voraussetzungen
Sie müssen als ein Benutzer angemeldet sein, der zur BizTalk Server-Administratorengruppe gehört.
Umschlagfelder, die geändert werden können
Nur folgende Umschlagfelder können geändert werden. Nur diese Felder sind im Erweiterungsschema enthalten. Weitere hinzugefügte Felder im Diensterweiterungsschema wirken sich nicht auf die Verarbeitung aus.
| Standard | Feld |
|---|---|
| X12 und HIPAA | ISA01 – Autorisierungsqualifizierer ISA03 – Sicherheitsqualifizierer ISA05 – Absender-ID-Qualifizierer ISA07 – Empfänger-ID-Qualifizierer GS01 – Funktionscode GS07 – Zuständige Agentur |
| EDIFACT | UNB2.2 – Absendercodequalifizierer UNB3.2 – Empfängercodequalifizierer |
Umschlagfelder, die nicht geändert werden sollten
Einige Felder im Umschlag beeinflussen das Verhalten der Engine. Hieraus resultiert, dass den für diese Felder vorhandenen Enumerationslisten keine Werte hinzugefügt werden sollten. Dabei handelt es sich um die folgenden Felder:
| Standard | Feld |
|---|---|
| X12 und HIPAA | ISA11 – Austauschkontrollstandards-Nummer ISA12 – Austauschkontroll-Versionsummer ISA14 – Bestätigungsanforderung |
| EDIFACT | UNB1.1 – Syntaxbezeichner UNB1.2 – Syntaxversionsnummer UNB9 – Bestätigungsanforderung |
So passen Sie eine Enumerationen im Umschlagschema an
Erstellen Sie in Visual Studio ein neues Projekt.
Fügen Sie das Schema X12_ServiceSchemaExtension.xsd (zum Ändern von X12- oder HIPAA-Enumerationen) oder das schema EDIFACT_ServiceSchemaExtension.xsd in \Program Files (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI zu einem BizTalk-Projekt im BizTalk-Editor hinzu. Öffnen Sie das Schema.
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 nach Bedarf der Liste der Werte hinzu, um sicherzustellen, dass in jeder Zeile im Bereich Werte ein Wert vorhanden ist. Klicken Sie auf OK.
Wichtig
Der Namespace des Dienstschemas kann nicht geändert werden. Das Schema sollte denselben Namespace und Stammknotennamen wie das ursprüngliche Erweiterungsschema besitzen, das mit dem Produkt installiert wurde.
Hinweis
Wenn Sie den Schemas neue Felder hinzufügen, werden diese ignoriert. Nur die Felder, die oben im Abschnitt Umschlagfelder, die geändert werden können, aufgeführt sind, können geändert werden.
Speichern Sie das Schema.
Klicken Sie mit der rechten Maustaste auf das Schema, und klicken Sie dann auf Bereitstellen.
Hinweis
Das Schema muss in der aktuellen BizTalk-Gruppe bereitgestellt werden.