Kommunikationskanäle konfigurieren
Verwendung
In diesem Kapitel konfigurieren Sie zwei Kommunikationskanäle, einen als Sender und den anderen als Empfänger, damit zwischen einem Partner und SAP XI Messages ausgetauscht werden können. Diese Informationen sind spezifisch für den Konfigurationstyp Antwortender von zwei Aktionen (siehe Antwortender von zwei Aktionen).
Empfänger-Kanal
Voraussetzungen
Sie haben einen Kommunikationskanal angelegt. Weitere Informationen hierzu finden Sie unter Zuordnung von Kommunikationskanälen.
Es wird empfohlen, beim Anlegen eines Kommunikationskanals die Kommunikationskanalvorlage zu verwenden. Die Vorlage ist ein Teil des Business Package für RNIF.
Wenn Sie Sicherheitseinstellungen in den Kanälen aktivieren möchten, haben Sie auch die im Abschnitt Sicherheitsservices im RNIF-Adapter beschriebenen Schritte durchgeführt.
Vorgehensweise
...
Folgende Konfigurationsaktivitäten werden im Abschnitt Integration Server durchgeführt:
1. Wechseln Sie vom Integration Builder zum Integration Directory.
Integration Builder: Das BildKonfigurationszeit wird angezeigt.
2. Wählen Sie in der Navigationsleiste den Kommunikationskanal.
3. Wählen Sie die Registerkarte Parameter, und geben Sie die Werte in den folgenden Abschnitten ein:
Typ des Kommunikationskanals
Feld |
Aktion |
Adaptertyp |
Wählen Sie RNIF. |
Sender oder Empfänger |
Wählen Sie Empfänger. |
Transport-Protokoll |
Wählen Sie HTTP 1.1 oder HTTPs Der Wert, den Sie hier wählen, bestimmt die Werte, die Sie unten im Abschnitt Authentifizierung angeben. |
Message-Protokoll |
Wählen Sie RNIF 1.1. |
Geben Sie eine Adapter-Engine auf dem Integration Server oder eine nicht-zentrale Adapter-Engine ein. |
Registerkarte Prozessspezifikation
Konfigurationstyp
Wählen Sie Asynchrone Anforderung mit zwei Aktionen.
Message-protokollspezifische Informationen
Die Werte, die Sie unten eingeben, werden vom PIP-Spezifikationsdokument aus für den PIP, den Sie verwenden möchten, referenziert.
Wenn die Geschäftssituation dies erfordert, können Sie diese Werte weiter abändern.
Die Werte in diesen Feldern werden verwendet, um die RNIF-Protokollfelder für alle Outbound-Action- oder -Signal-Messages auszufüllen. Im Falle von Inbound-RNIF-Messages werden die RNIF-Protokollfelder gegen die entsprechenden Felder in der Konfiguration des Kommunikationskanals abgeglichen. Nur folgende Felder werden überprüft:
● Prozessname
● Transaktionsname
● Message-Version (wird nur für Action-Messages überprüft)
Wenn der Adapter ein Feld nicht erfolgreich gegen die Konfiguration im Kanal abgleichen kann, wird ein allgemeines Ausnahmesignal an den Partner gesendet.
Feld |
Aktion |
RNIF-Protokollfeld |
Geben Sie den Namen von der Titelseite des PIP-Spezifikationsdokuments an. Beispiel: Asynchrone Benachrichtigung für PIP0C1 |
ServiceHeader- ProcessControl/ ProcessIdentity/ GlobalProcessCode |
|
Transaktionsname |
Geben Sie den Wert aus der Spalte Aktivitätsname der Tabelle Beschreibungen der Geschäftsaktivität im PIP-Spezifikationsdokument ein. Beispiel: Notify of remittance advice |
ServiceHeader-ProcessControl/ TransactionControl/ TransactionIdentity/ GlobalTransactionCode |
Message-Version |
Geben Sie den Wert aus dem PIP Version Identifier vom Titelblatt des PIP-Spezifikationsdokuments an. Beispiel: Wenn der PIP Version Identifier im Spezifikationsdokument V02.02 ist, ist die Version V0202. |
ServiceHeader- ProcessControl/ TransactionControl/ ActionControl/ ActionIdentity/ VersionIdentifier |
Aktueller Business-Service-Code |
Geben Sie den Wert aus der Spalte Netzwerkkomponente in FSV der Spezifikationstabelle für Netzwerkkomponenten im PIP-Spezifikationsdokument ein. Der Wert entspricht der von XI angenommenen Rolle im PIP. Beispiele: Käuferservice, Initiatorservice |
ServiceHeader- ProcessControl/ ServiceRoute/ fromService/ BusinessServiceDescription/ GlobalBusinessServiceCode |
Partner-Business-Servicecode |
Geben Sie den Wert aus der Spalte Netzwerkkomponente in FSV der Spezifikationstabelle für Netzwerkkomponenten im PIP-Spezifikationsdokument ein. Der Wert entspricht der vom Partner angenommenen Rolle im PIP. Beispiele: Verkäuferservice, Service für Antwortenden |
ServiceHeader- ProcessControl/ ServiceRoute/ toService/ BusinessServiceDescription/ GlobalBusinessServiceCode |
Aktueller Klassifikationscode |
Geben Sie einen Wert aus der Entity-Liste für das Element GlobalPartnerClassification Code in der Richtlinie für RosettaNet-Service-Header-Messages ein. Diese Richtlinie ist Teil des Spezifikationsdokuments für RNIF 1.1. Wählen Sie entsprechend dem aktuell ausführenden PIP den passendsten Wert für Aktivität und Aktion im PIP-Spezifikationsdokument. Das Feld beschreibt die Funktion von XI in der Logistikkette. Beispiele: Product Supplier, Supplier |
ServiceHeader- ProcessControl/ TransactionControl/ ActionControl/ PartnerRoute/ fromPartner. PartnerDescription/ GlobalPartner ClassificationCode |
Partner-Klassifikationscode |
Geben Sie einen Wert aus der Entity-Liste für das Element GlobalPartnerClassification Code in der Richtlinie für RosettaNet-Service-Header-Messages ein. Diese Richtlinie ist Teil des Spezifikationsdokuments für RNIF 1.1. Wählen Sie entsprechend dem aktuell ausführenden PIP den passendsten Wert für Aktivität und Aktion im PIP-Spezifikationsdokument. Das Feld beschreibt die Funktion des Partners in der Logistikkette. Geben Sie den Wert aus dem ToRole-Element (gegebenenfalls FromRole-Element) der entsprechenden PIP-Spezifikation ein; hierbei sind der aktuell ausgeführte PIP, die Aktivität sowie die Aktion zu berücksichtigen. Beispiele: Product Supplier, Distributor |
ServiceHeader- ProcessControl/ TransactionControl/ ActionControl/ PartnerRoute/ toPartner. PartnerDescription/ GlobalPartner ClassificationCode |
PIP-Informationen
Die Felder in diesem Abschnitt beschreiben Adaptermetadaten. Weitere Informationen zur Adapterentwicklung finden Sie unter: Adapter- und Modulentwicklung.
Konfigurieren Sie diese Felder nur, wenn Sie Anpassungen an Partnerimplementierungen vornehmen, die von den angegebenen RosettaNet-Standards abweichen.
Die Werte in diesen Feldern werden verwendet, um die RNIF-Protokollfelder für alle Outbound-Action- oder -Signal-Messages auszufüllen. Im Falle von Inbound-RNIF-Messages werden die RNIF-Protokollfelder gegen die entsprechenden Felder in der Konfiguration des Kommunikationskanals abgeglichen. Nur folgende Felder werden überprüft:
● Code
● Anforderung
Wenn der Adapter ein Feld nicht erfolgreich gegen die Konfiguration im Kanal abgleichen kann, wird ein allgemeines Ausnahmesignal an den Partner gesendet.
Feld |
Aktion |
RNIF-Protokollfeld |
Code |
Geben Sie den PIP-Standard-Code an. Beispiel: 3A7 |
ServiceHeader- ProcessControl/ ProcessIdentity/ GlobalProcessIndicatorCode |
Version |
Geben Sie den Wert aus dem PIP Version Identifier vom Titelblatt des PIP-Spezifikationsdokuments an. Beispiel: Wenn der PIP Version Identifier im Spezifikationsdokument V02.02 ist, ist die Version V0202. |
ServiceHeader- ProcessControl/ ProcessIdentity/ VersionIdentifier |
Anforderung |
Fügen Sie den Wert aus der Spalte Business Action in FSV der Tabelle Business Action - Business Document Mapping im PIP-Spezifikationsdokument ein. Beispiel: Asynchronous Test Notification Action |
ServiceHeader- ProcessControl/ TransactionControl/ ActionControl/ ActionIdentity/ GlobalBusinessActionCode |
Aktuelle Rolle |
Geben Sie den Wert aus der Spalte Role Name der Tabelle Partner Role Descriptions im PIP-Spezifikationsdokument ein. Der Wert entspricht der von XI angenommenen Rolle im PIP. Beispiele: Buyer, Initiator |
ServiceHeader- ProcessControl/ TransactionControl/ PartnerRoleRoute/ fromRole. PartnerRoleDescription/ GlobalPartnerRole ClassificationCode |
Partnerrolle |
Geben Sie den Wert aus der Spalte Role Name der Tabelle Partner Role Descriptions im PIP-Spezifikationsdokument ein. Der Wert sollte der vom Partner angenommenen Rolle im PIP entsprechen. Beispiele: Seller, Responder |
ServiceHeader- ProcessControl/ TransactionControl/ PartnerRoleRoute/ toRole. PartnerRoleDescription/ GlobalPartnerRole ClassificationCode |
Dokumentschema-Spezifikation |
Geben Sie die DTD für die entsprechende Aktion vom XI Integration Builder an. Konfigurieren Sie dieses Feld nur für den Empfängerkanal. Beispiel: 1_MS_R01_02_Asynchronous TestNotification.dtd |
URI-Referenz zu externer DTD als Systemkennung, die in der DOCTYPE-XML-Verarbeitungsanweisung erstellt wird. |
Einstellungen zur Message-Verarbeitung
Feld |
Aktion |
Anzahl Wiederholungen |
Sie können den angezeigten Standardwert verwenden oder einen neuen Wert aus der Spalte Retry Count der Tabelle Business Activity Performance Controls im PIP-Spezifikationsdokument eingeben. Dieser Wert zeigt an, wie oft die Action-Message rückübertragen wird bevor der Adapter ein Signal vom Partner empfängt. |
Frist für Empfangsbestätigung |
Geben Sie den Wert aus der Spalte Time to Acknowledge der Tabelle Business Activity Performance Controls im PIP-Spezifikationsdokument ein. Konfigurieren Sie dieses Attribut nur für den Empfängerkanal. |
Frist für Ausführung |
Geben Sie den Wert aus der Spalte Time to Perform der Tabelle Business Activity Performance Controls im PIP-Spezifikationsdokument ein. |
Sicherheitskonzept
Feld |
Aktion |
Action-Message signieren |
Markieren oder entmarkieren Sie Action-Message signieren. Wenn Sie das Feld markieren, muss die Action-Message vor dem Versand signiert werden. |
Signal-Message signieren |
Markieren oder entmarkieren Sie Signal-Message signieren. Wenn Sie das Feld markieren, muss die Signal-Message vor dem Empfang signiert werden. |
Unleugbarkeit |
Markieren oder entmarkieren Sie Unleugbarkeit. Um die Unleugbarkeit zu aktivieren, müssen Sie die Option Message signieren auswählen. |
Registerkarte Ziel
Transportparameter
Feld |
Aktion |
URL |
Geben Sie die Partneradresse ein, an die der Adapter die RosettaNet-Signal-Message sendet. |
Sie können den angezeigten Standardwert verwenden oder eine neue Zeit im verfügbaren Format eingeben. |
Authentifizierung
Die Werte, die Sie hier eingeben, werden durch das vorher eingegebene Transportprotokoll bestimmt.
Wenn Sie HTTP 1.1 verwenden, sind folgende Felder verfügbar:
Feld |
Aktion |
Erfordert Client-Authentifizierung |
Markieren oder entmarkieren Sie Erfordert Client-Authentifizierung. |
Benutzername |
Geben Sie den vom Partner zur Verfügung gestellten Wert ein. |
Kennwort |
Geben Sie den vom Partner zur Verfügung gestellten Wert ein. |
Wenn Sie HTTPs verwenden, sind folgende Felder verfügbar:
Feld |
Aktion |
Authentifizierungsmodus |
Wählen Sie Benutzername/Kennwort oder Zertifikatsanmeldung. Der Wert, den Sie hier eintragen, bestimmt zusätzliche Details, die Sie eintragen müssen. |
Wenn Sie Benutzername/Kennwort verwenden, sind folgende Felder verfügbar:
Feld |
Aktion |
Benutzername |
Geben Sie den vom Partner zur Verfügung gestellten Wert ein. |
Kennwort |
Geben Sie den vom Partner zur Verfügung gestellten Wert ein. |
Wenn Sie Zertifikatsanmeldung verwenden, sind folgende Felder verfügbar:
Feld |
Aktion |
Schlüsselspeichersicht |
Geben Sie den Pfad zu den Schlüsselspeichereinträgen in der J2EE Engine ein, die den privaten Schlüssel des XI-Partners enthalten. Beispiel: SslService |
Schlüsselspeichereintrag |
Geben Sie den Namen des privaten Schlüssels des XI-Partners ein. Beispiel: SslCredentials |
Registerkarte Erweitert
Adapterspezifische Message-Eigenschaften
Feld |
Aktion |
Adapterspezifische Message-Eigenschaften |
Markieren oder entmarkieren Sie Adapterspezifische Message-Eigenschaften einstellen. Mit Ihrer Auswahl legen Sie fest, ob Attribute zur Auswahl verfügbar sind. |
Wenn Sie Adapterspezifische Message-Eigenschaften einstellen wählen, stehen folgende Felder zur Verfügung:
Feld |
Technischer Name |
Aktion |
Prozess-Instanz-ID |
Proc Inst Identifier |
Markieren oder entmarkieren Sie Prozess-Instanz-ID. Bezeichnet eine eindeutige alphanumerische ID, die eine spezielle Instanz eines Business-Prozesses darstellt. |
Message-ID |
Message-ID |
Markieren oder entmarkieren Sie Message-ID. Kennzeichnet eine eindeutige alphanumerische ID, die die Message für das Tracking darstellt. Diese ID ist im Kontext des Message-Senders eindeutig. |
Dokument-ID |
Dokument-ID |
Markieren oder entmarkieren Sie Dokument-ID. Kennzeichnet eine eindeutige alphanumerische ID, die das PIP-Business-Dokument darstellt. |
Datum-/Zeitstempel des Dokuments |
Document Date Time |
Markieren oder entmarkieren Sie Datum-/Zeitstempel des Dokuments. Bezeichnet Datum und Zeit, wann die Message an den Partner gesendet wird. |
Sender-Kanal
Voraussetzungen
Sie haben einen Kommunikationskanal angelegt. Weitere Informationen hierzu finden Sie unter Zuordnung von Kommunikationskanälen.
Es wird empfohlen, beim Anlegen eines Kommunikationskanals die Kommunikationskanalvorlage zu verwenden. Die Vorlage ist ein Teil des Business Package für RNIF.
Wenn Sie Sicherheitseinstellungen in den Kanälen aktivieren möchten, haben Sie auch die im Abschnitt Sicherheitsservices im RNIF-Adapter beschriebenen Schritte durchgeführt.
Vorgehensweise
...
Folgende Konfigurationsaktivitäten werden im Abschnitt Integration Server durchgeführt:
1. Wechseln Sie vom Integration Builder zum Integration Directory.
Integration Builder: Das BildKonfigurationszeit wird angezeigt.
2. Wählen Sie in der Navigationsleiste den Kommunikationskanal.
3. Wählen Sie die Registerkarte Parameter, und geben Sie die Werte in den folgenden Abschnitten ein:
Kommunikationskanaltypen
Feld |
Aktion |
Adaptertyp |
Wählen Sie RNIF11. |
Sender oder Empfänger |
Wählen Sie Sender. |
Transport-Protokoll |
Wählen Sie HTTP 1.1 oder HTTPs |
Message-Protokoll |
Wählen Sie RNIF 1.1. |
Geben Sie eine Adapter-Engine auf dem Integration Server oder eine nicht-zentrale Adapter-Engine ein. |
Registerkarte Prozessspezifikation
Konfigurationstyp
Wählen Sie Asynchrone Antwort mit zwei Aktionen.
Message-protokollspezifische Informationen
Die Werte, die Sie unten eingeben, werden vom PIP-Spezifikationsdokument aus für den PIP, den Sie verwenden möchten, referenziert.
Wenn die Geschäftssituation dies erfordert, können Sie diese Werte weiter abändern.
Die Werte in diesen Feldern werden verwendet, um die RNIF-Protokollfelder für alle Outbound-Action- oder -Signal-Messages auszufüllen. Im Falle von Inbound-RNIF-Messages werden die RNIF-Protokollfelder gegen die entsprechenden Felder in der Konfiguration des Kommunikationskanals abgeglichen.
Wenn der Adapter ein Feld nicht erfolgreich gegen die Konfiguration im Kanal abgleichen kann, wird ein allgemeines Ausnahmesignal an den Partner gesendet.
Feld |
Aktion |
RNIF-Protokollfeld |
Supply-Chain-Code |
Geben Sie einen Wert aus der Entity-Liste für das Element GlobalSupplyChainCode in der Richtlinie für RosettaNet-Empfangsbestätigungs-Messages ein. Diese Richtlinie ist Teil des Spezifikationsdokuments für RNIF 1.1. Beispiel: Electronic Components |
ReceiptAcknowledgment Payload -fromRole. PartnerRoleDescription/ PartnerDescription/ BusinessDescription/ GlobalSupplyChainCode |
PIP-Informationen
Die Felder in diesem Abschnitt beschreiben Adaptermetadaten. Weitere Informationen zur Adapterentwicklung finden Sie unter: Adapter- und Modulentwicklung.
Konfigurieren Sie diese Felder nur, wenn Sie Anpassungen an Partnerimplementierungen vornehmen, die von den angegebenen RosettaNet-Standards abweichen.
Die Werte in diesen Feldern werden verwendet, um die RNIF-Protokollfelder für alle Outbound-Action- oder -Signal-Messages auszufüllen. Im Falle von Inbound-RNIF-Messages werden die RNIF-Protokollfelder gegen die entsprechenden Felder in der Konfiguration des Kommunikationskanals abgeglichen. Nur folgendes Feld wird abgeglichen: Antwort.
Wenn der Adapter ein Feld nicht erfolgreich gegen die Konfiguration im Kanal abgleichen kann, wird ein allgemeines Ausnahmesignal an den Partner gesendet.
Feld |
Aktion |
RNIF-Protokollfeld |
Antwort |
Fügen Sie den Wert aus der Spalte Business Action in FSV der Tabelle Business Action - Business Document Mapping im PIP-Spezifikationsdokument ein. Beispiel: Purchase Order Confirmation Action |
ServiceHeader- ProcessControl/ TransactionControl/ ActionControl/ ActionIdentity/ GlobalBusinessActionCode |
Einstellungen zur Message-Verarbeitung
Feld |
Aktion |
Anzahl Wiederholungen |
Sie können den angezeigten Standardwert verwenden oder einen neuen Wert aus der Spalte Retry Count der Tabelle Business Activity Performance Controls im PIP-Spezifikationsdokument eingeben. Der Wert wird verwendet, um die Zahl der Wiederholungsversuche vom Partner aus zu beschränken. |
Empfangsbestätigung |
Wählen Sie Stark oder Schwach. Konfigurieren Sie dieses Attribut nur für den Senderkanal. |
Sicherheitskonzept
Feld |
Aktion |
Action-Message signieren |
Markieren oder entmarkieren Sie Action-Message signieren. Wenn Sie das Feld markieren, muss die Action-Message vor dem Empfang signiert werden. |
Signal-Message signieren |
Markieren oder entmarkieren Sie Signal-Message signieren. Wenn Sie das Feld markieren, muss die Signal-Message vor dem Versand signiert werden. |
Markieren oder entmarkieren Sie Unleugbarkeit. Um die Unleugbarkeit zu aktivieren, müssen Sie die Option Message signieren auswählen. |
Siehe auch:
● Adapter