Erstellen oder Bearbeiten einer Vereinbarung
In diesem Thema wird beschrieben, wie Sie eine Handelspartnervereinbarung erstellen oder bearbeiten. Eine Handelspartnervereinbarung konfiguriert die Beziehung zwischen zwei Handelspartnern, einschließlich ihrer Identitäten; partner interface process (PIP); die Aktions-, Signal- und Synchronisierungs-URLs; und den zugeordneten Protokollen.
Eine Handelspartnervereinbarung enthält die Einstellungen für eine Prozesskonfiguration, home organization, Partner und Vereinbarung. Alle diese Einstellungen sind für eine Vereinbarung erforderlich. Sie können eine Prozesskonfiguration basierend auf einem RosettaNet-PIP oder einem benutzerdefinierten Schema erstellen, aber Sie müssen die Konfiguration erstellen. Außerdem müssen Sie sowohl einen organization als auch einen Partner organization definieren. Microsoft BizTalk Accelerator for RosettaNet (BTARN) unterstützt keinen Nachrichtenaustausch zwischen unbekannten Parteien.
BTARN verarbeitet und überprüft eine Nachricht basierend auf all diesen Einstellungen. Für eine CIDX-Nachricht überprüft BTARN z. B. basierend auf der Version des RosettaNet Implementation Framework (RNIF) (nur 1.1), der Vereinbarung 0A1 (nur no 0A1) und der Is Single Action Eigenschaft (nur single-action). Eine CIDX-Nachricht wird nur überprüft, wenn Sie die RNIF-Version auf "1.1", die 0A1-Vereinbarung auf "No 0A1" und die Is Single Action -Eigenschaft auf Truefestlegen. BTARN überprüft auch, ob alle Vertragseigenschaften mit den Einstellungen des Prozesskonfigurationsprofils konsistent sind. Beispielsweise wird überprüft, ob Sie die Standard Eigenschaft des Profils auf "CIDX" festgelegt haben und dass die 0A1-Vertragseigenschaft der Vereinbarung auf "No 0A1" festgelegt ist.
Wenn Sie eine Vereinbarung ändern, während ein Prozess aktiv ist, können unvorhersehbare Ergebnisse auftreten. Die Änderungen an den Vertragseigenschaften gelten, sobald Sie auf Übernehmen oder OK klicken, um sie zu akzeptieren, aber Sie können nicht vorhersagen, welche Phase eines Prozesses ausgeführt wird. Nachdem Sie die Vereinbarung geändert haben, verwendet jede neue Aktivität in einem aktuellen Prozess oder einem neuen Prozess die geänderten Vertragseigenschaften. Ein Prozess, der ausgeführt wird, wenn Sie die Vereinbarung ändern, hat jedoch möglicherweise bereits die vorherigen Vertragseigenschaften für eine Nachricht verwendet, die verarbeitet wird.
Nachdem Sie eine Vereinbarung erstellt haben, müssen Sie sie aktivieren, damit nachrichten, die der Vereinbarung zugeordnet sind, gesendet oder empfangen werden können. Sie können auch eine Vereinbarung deaktivieren, um zu verhindern, dass nachrichten, die der Vereinbarung zugeordnet sind, gesendet oder empfangen werden. Sie müssen eine Vereinbarung deaktivieren, um sie zu bearbeiten, und sie dann nach der Bearbeitung erneut aktivieren.
BTARN speichert diese Informationen in der TPAConfig-Tabelle in der BTARNCONFIG-Datenbank.
Die Einstellungen im Handelspartnervertrag sind wie in der folgenden Tabelle nach Registerkarte angeordnet. Die Standardeinstellungen sind die am häufigsten verwendeten Werte. Verfahren zum Erstellen und Bearbeiten dieser Einstellungen werden nach der Tabelle angezeigt.
| Registerkarte | Einstellung | Verwendung |
|---|---|---|
| Allgemein | Name | Ein eindeutiger Name für die Vereinbarung, z. B. Fabrikam_To_Contoso_3A2. Dieses Feld ist erforderlich. |
| Allgemein | Prozesskonfiguration | Der Bezeichner für das PIP. Diese Nummer gibt an, welche Prozesskonfiguration dieser Vereinbarung zugeordnet ist. Der Standardwert ist der erste in der Liste der Prozesskonfigurationen. Die Dropdownliste enthält alle zuvor eingegebenen Prozesskonfigurationen. Dieses Feld ist erforderlich. |
| Allgemein | Eigene Organisation | Die Startseite organization aus einer Dropdownliste ausgewählt. Dieses Feld ist erforderlich. |
| Allgemein | Partner-organization | Der Partner organization aus einer Dropdownliste ausgewählt. Dieses Feld ist erforderlich. |
| Allgemein | Beschreibung | Eine Beschreibung des Handelspartnervertrags. |
| Allgemein | RNIF-Version | Die Version des RNIF, die BTARN für die Vertragskommunikation verwendet. Kann V01.10.00 oder V02.00.01 (Standard) sein. Muss für CIDX V01.10.00 sein. |
| Allgemein | Startrolle | Die Rolle des organization. Dies kann eine Initiatorrolle oder eine Antwortrolle sein. |
| Allgemein | 0A1-Vereinbarung | Gibt an, ob BTARN eine Benachrichtigung über einen Fehler (0A1 PIP) zurückgibt, wenn ein Fehler auftritt. Kann No 0A1 (Standard) oder 0A1 sein. Für CIDX muss No 0A1 festgelegt sein. |
| Allgemein | Verwendung | Gibt den Typ des Szenarios an, das von der Vereinbarung verwendet wird. Dies kann "Test " (Standardeinstellung) oder "Produktion" sein. |
| Allgemein (Anwendungsadapterbereich ) |
Assemblyname | Der Dateiname des ApplicationAdapters, den Sie im Dateisystem auswählen können. Der Standardwert ist eine leere Zeichenfolge. |
| Allgemein (Anwendungsadapterbereich) |
Klassenname | Der Name der Klasse, die BTARN aus dem ApplicationAdapter verwendet. Der Standardwert ist <none>. |
| Allgemein (Bereich des Validierungsadapters) |
Assemblyname | Der Dateiname des ValidationAdapters, den Sie im Dateisystem auswählen können. Der Standardwert ist eine leere Zeichenfolge. |
| Allgemein (Bereich des Validierungsadapters) |
Klassenname | Der Name der Klasse, die BTARN aus dem ValidationAdapter verwendet. Der Standardwert ist <none>. |
| Ports | Aktions-URL | Die URL, an die die Startseite organization eine Aktionsnachricht sendet. Beispiel: http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Dies ist ein erforderliches Feld, wenn folgendes zutrifft: – Die Einstellung Ist synchrone Prozesskonfiguration ist False.– Die Konfigurationseinstellung für den Prozess "Is Single Action " ist True.– Die Einstellung Der Startrollenvereinbarung ist Initiator. Dies ist auch ein erforderliches Feld, wenn Folgendes zutrifft (in diesem Fall ist auch das Feld Signal-URL erforderlich): – Die Einstellung Ist synchrone Prozesskonfiguration ist False.– Die Konfigurationseinstellung für den Prozess "Is Single Action " ist False.– Sie müssen in diesem Feld einen gültigen URI eingeben, der mit "< http://domain>" oder "<https://domain>" beginnt. |
| Ports | Signal-URL | Die URL, an die der organization eine Signalnachricht sendet. Beispiel: http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Dies ist ein erforderliches Feld, wenn Folgendes zutrifft: – Die Einstellung Ist synchroner Prozesskonfiguration ist False.– Die Einstellung Für den Einzelaktionsprozesskonfiguration ist True.– Die Einstellung "Home role agreement" lautet Responder. Dies ist auch ein erforderliches Feld, wenn Folgendes zutrifft (in diesem Fall ist auch das Feld Aktions-URL erforderlich): – Die Einstellung Ist synchroner Prozesskonfiguration ist False.– Die Einstellung Für den Einzelaktionsprozesskonfiguration ist False.In diesem Feld müssen Sie einen gültigen URI eingeben, der mit "< http://domain>" oder "<https://domain>" beginnt. |
| Ports | Sync-URL | Die URL, die der organization zum Herstellen einer Verbindung über den HTTP-Adapter verwendet. Beispiel: http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Dies ist ein erforderliches Feld, wenn Folgendes zutrifft: – Die Einstellung Ist synchroner Prozesskonfiguration ist True.– Die Einstellung "Home role agreement" lautet Initiator. In diesem Feld müssen Sie einen gültigen URI eingeben, der mit "< http://domain>" oder "<https://domain>" beginnt. |
| Protokoll | Digest-Methode | Das Protokoll, das verwendet wird, um den Digest eingehender Nachrichten für Nicht-Ablehnungszwecke zu berechnen. Ab BizTalk Server 2016 und neueren Versionen ist die SHA2-Unterstützung automatisch enthalten. Zu den Optionen gehören MD5, SHA-1, SHA-256 (Standard), SHA-384 und SHA-512. Für frühere BizTalk Server Versionen umfassen die Optionen MD5 oder SHA-1 (Standard). Die BTARN-Empfangspipeline empfängt und entschlüsselt eine Nachricht, auch wenn das Protokoll, das zum Verschlüsseln der Nachricht verwendet wird, und die Einstellung Codierung auf dieser Registerkarte der Vereinbarung nicht übereinstimmen. Daher empfängt BTARN Nachrichten, die entweder in RC2-40 oder 3DES verschlüsselt sind. Alle ausgehenden signierten Nachrichten verfügen über einen Digest von SHA-1. |
| Protokoll | Codieren aller Teile | Gibt an, ob das System alle Teile der mehrteiligen Nachricht zusammen codiert. Kann oder False sein True (Standard).Wenn True, werden alle Teile der mehrteiligen Nachricht mit der von der Encoding -Eigenschaft angegebenen Methode zusammen codiert.Wenn False, codiert das System Anlagen nur mit der von der Encoding -Eigenschaft angegebenen Methode. (Anlagen werden immer von der Sendepipeline mit der von der Encoding -Eigenschaft angegebenen Methode codiert.) Wenn Sie diese Eigenschaft auf Falsefestlegen, codiert BTARN standardmäßig die anderen Teile der Nachricht (vier Teile in RNIF 2.01, drei Teile in RNIF 1.1) in Anführungszeichen. |
| Protokoll | Codieren | Das Protokoll, das zum Codieren aller Teile (wenn das Feld Alle Teile codieren) oder die Anlage (wenn das Feld Alle Teile codieren ) verwendet wirdFalseTrue.Kann 8 Bit, Basis 64 (Standard) oder in Anführungszeichen gedruckt werden. |
| Protokoll | Verschlüsselungsalgorithmus | Der Algorithmus, der zum Verschlüsseln eingehender und ausgehender Nachrichten verwendet wird. Ab BizTalk Server 2016 und neueren Versionen ist die AES-Unterstützung automatisch enthalten. Die Optionen umfassen RC2-40, 3DES, AES128 (Standard), AES192 und AES256. Für frühere BizTalk Server Versionen umfassen die Optionen RC2-40 (Standard) oder 3DES. Der Verschlüsselungsalgorithmus wird nur wirksam, wenn Sie die Is Persistent Confidentiality Required Eigenschaft entweder Nutzlast oder Nutzlastcontainer in der entsprechenden Prozesskonfiguration festgelegt haben. |
| Protokoll | Verschlüsselungsrichtung | Gibt an, ob das System die eingehende Nachricht oder die ausgehende Nachricht oder beides verschlüsselt. Kann eingehender, ausgehender oder eingehender/ausgehender Wert (Standard) sein. Die Einstellung für die Verschlüsselungsrichtung wird nur wirksam, wenn Sie die Is Persistent Confidentiality Required Eigenschaft entweder Nutzlast oder Nutzlastcontainer in der entsprechenden Prozesskonfiguration festgelegt haben. |
| Benutzerdefinierte Eigenschaften | Name | Name der benutzerdefinierten Eigenschaft. Sie können benutzerdefinierte Eigenschaften auf Vereinbarungsbasis festlegen. Wenn Sie einen neuen benutzerdefinierten privaten Prozess erstellen, können Sie diese benutzerdefinierten Eigenschaften zum Verarbeiten verschiedener Vereinbarungen verwenden. Sie können die RuntimeConfig.GetTPACustomConfigValue -Methode im BTARN SDK verwenden, um benutzerdefinierte Eigenschaften aus der BTARN-Konfiguration abzurufen.Die Name Eigenschaft muss eindeutig und nicht leer sein.Sie können die folgenden benutzerdefinierten Werte eingeben: - AAR. Dies ist die benutzerdefinierte Eigenschaft "Akzeptanzbestätigung erforderlich". Dies gilt nur für RNIF 1.1. Legen Sie dies auf false fest (wobei die Groß-/Kleinschreibung nicht beachtet wird), um nur eine Empfangsbestätigung und keine Annahmebestätigung zu erfordern. Wenn AAR auf einen anderen Wert als false festgelegt ist, muss der öffentliche Prozess des Antwortgebers eine Annahmebestätigung senden, und der öffentliche Prozess des Initiators erwartet eine Annahmebestätigung. Wenn AAR auf false festgelegt ist, werden die öffentlichen Prozesse nach der Empfangsbestätigung abgeschlossen. - HPCC. Dies ist der Home Partner-Klassifizierungscode. Dies gilt nur für RNIF 1.1. Dadurch können Sie das GlobalPartnerClassificationCode-Element für den Homepartner im Dienstheader einer ausgehenden Nachricht auf den Eintrag in der Spalte Wert festlegen. Dieser Wert überschreibt die Klassifizierungseigenschaft Home organization in der Konfiguration "Home Organization". Verwenden Sie diese benutzerdefinierte Eigenschaft, wenn die home organization mehr als eine Klassifizierung aufweisen kann. - PPCC. Dies ist der Partnerprofilklassifizierungscode. Dies gilt nur für RNIF 1.1. Dadurch können Sie das GlobalPartnerClassificationCode-Element für den Partner im Dienstheader einer ausgehenden Nachricht auf den Eintrag in der Spalte Wert festlegen. Dieser Wert überschreibt die Partnerklassifizierungseigenschaft in der Partnerkonfiguration. Verwenden Sie diese benutzerdefinierte Eigenschaft, wenn der Partner mehrere Klassifizierungen aufweisen kann. |
| Benutzerdefinierte Eigenschaften | Wert | Wert der benutzerdefinierten Eigenschaft. |
Erstellen eines Handelspartnervertrags
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf MicrosoftBizTalk Accelerator for RosettaNet, und klicken Sie dann auf BizTalk Accelerator for RosettaNetManagement Console.
Erweitern Sie in der BTARN-Verwaltungskonsole BizTalk Accelerator for RosettaNet.
Klicken Sie mit der rechten Maustaste auf Vereinbarungen, zeigen Sie auf Neu, und klicken Sie dann auf Vereinbarung.
Geben Sie im Dialogfeld Neue Vereinbarungseigenschaften auf den Registerkarten Allgemein, Ports, Protokoll und Benutzerdefinierte Eigenschaften die Werte für Einstellungen ein. Informationen zu diesen Einstellungen finden Sie in der obigen Tabelle.
Klicken Sie auf OK.
Hinweis
BTARN akzeptiert keine Nachrichten im Zusammenhang mit der Vereinbarung, bis Sie die Vereinbarung aktivieren.
Klicken Sie im rechten Bereich mit der rechten Maustaste auf den Namen der Vereinbarung, und klicken Sie dann auf Aktivieren.
Hinweis
Wenn Sie bereits eine Vereinbarung aktiviert haben, können Sie im rechten Bereich mit der rechten Maustaste auf den Namen der Vereinbarung klicken und dann auf Deaktivieren klicken, um zu verhindern, dass nachrichten, die der Vereinbarung zugeordnet sind, gesendet oder empfangen werden.
Bearbeiten einer Handelspartnervereinbarung
Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf MicrosoftBizTalk Accelerator for RosettaNet, und klicken Sie dann auf BizTalk Accelerator for RosettaNetManagement Console.
Erweitern Sie in der BTARN-Verwaltungskonsole bizTalk Accelerator for RosettaNet, und klicken Sie dann auf den Knoten Vereinbarungen .
Klicken Sie mit der rechten Maustaste auf die Vereinbarung, die Sie bearbeiten möchten, und klicken Sie dann auf Eigenschaften.
Ändern Sie im Dialogfeld Eigenschaften des <Vertragsnamens> auf den Registerkarten Allgemein und Kontakteigenschaften die Einstellungen nach Bedarf. Informationen zu diesen Einstellungen finden Sie in der obigen Tabelle.
Klicken Sie auf OK.
Weitere Informationen
Verwalten der Konfiguration, der Zertifikate, der Datenbanken und der Sicherheit
Verwalten der BTARN-Konfiguration