InterChange Server konfigurieren

Für die Interaktionen zwischen Business Integration Connect und InterChange Server müssen Sie eine Integrationskomponentenbibliothek (Integration Component Library - ICL) im Tool 'System Manager' erstellen. Diese ICL enthält die folgenden Artefakte:

Darüber hinaus müssen Sie auch ein Benutzerprodukt erstellen und aus der ICL die Artefakte auswählen, die für Ihre spezielle Interaktion zwischen InterChange Server und Business Integration Connect erforderlich sind.

Anmerkung:
Weitere Informationen zur Erstellung von ICLs und zur Konfiguration von InterChange Server finden Sie im Handbuch System Implementation Guide in der Dokumentation zu WebSphere InterChange Server.

Geschäftsobjektdefinitionen erstellen

Business Integration Connect sendet Ihre Nachricht an eine ICS-kompatible Komponente, von der sie in Form von mindestens einem Geschäftsobjekt an InterChange Server weitergeleitet wird. Damit InterChange Server ein Geschäftsobjekt erkennen kann, muss InterChange Server zunächst eine Schablone lokalisieren, die als Geschäftsobjektdefinition bezeichnet wird und die Struktur der in diesem Geschäftsobjekt enthaltenen Informationen beschreibt. Jede Einzelinformation in einer Geschäftsobjektdefinition wird in einem Attribut untergebracht. Daher müssen Sie Geschäftsobjektdefinitionen erstellen, um die Informationen in Ihrer Nachricht darzustellen. Zur Erstellung von Geschäftsobjektdefinitionen verwenden Sie das Tool 'Business Object Designer'.

Anmerkung:
Das Tool 'Business Object Designer' ist Teil der beiden Produkte WebSphere InterChange Server und WebSphere Business Integration Adapter. Weitere Informationen zur Verwendung dieses Tools finden Sie im Handbuch Business Object Development Guide.

InterChange Server verwendet Geschäftsobjekte für die folgenden Informationen:

Geschäftsobjekt für das Dokument

Zur Aufnahme der Nutzinformationen (payload) des Business Integration Connect-Dokuments oder der Nachricht müssen Sie eine Geschäftsobjektdefinition definieren, die das Geschäftsobjekt für Nutzinformationen darstellt. Das Geschäftsobjekt für Nutzinformationen ist die Form, in der die ICS-kompatible Komponente das Dokument an (oder von) InterChange Server überträgt. Dieser Abschnitt enthält die folgenden Informationen zum Geschäftsobjekt für Nutzinformationen:

Geschäftsobjektstruktur

Das Geschäftsobjekt für Nutzinformationen muss so entworfen werden, dass für jede Einzelinformation im Dokument, die Sie übertragen möchten, ein Attribut in der zugeordneten Definition für das Geschäftsobjekt für Nutzinformationen vorhanden ist. Wie Tabelle 33 zeigt, ist der Inhalt des Geschäftsobjekts für Nutzinformationen von der Struktur des Dokuments und dem vom Dokument verwendeten Pakettyp abhängig.

Tabelle 33. Beziehung des Pakettyps zur Struktur des Geschäftsobjekts für Nutzinformationen
Dokumentstruktur Pakettyp Definition des Geschäftsobjekts für Nutzinformationen
Nur Nutzinformationen Kein Paket Enthält die Nutzinformationen des Dokuments.
Nur Nutzinformationen Back-End-Integration

Enthält:

  • Die Nutzinformationen des Dokuments
  • Header der Transportebene

Nutzinformationen und Anhänge Kein Paket Nicht möglich. Sie müssen das Back-End-Integrationspaket verwenden, wenn Ihr Dokument Anhänge enthält.
Nutzinformationen und Anhänge

Das Dokument enthält einen XML-Wrapper, der als Transporthülle bezeichnet wird, in den sowohl die Nutzinformationen als auch Anhänge gepackt sind.

Back-End-Integration

Enthält:

  • Die Nutzinformationen des Dokuments
  • Header der Transportebene
  • Container für Anhänge, der die Anhangsdaten und etwaige Anhangsgeschäftsobjekte enthält

Ein von Business Integration Connect bereitgestellter Data-Handler, der als Attachment-Data-Handler bezeichnet wird, ist zur Verarbeitung der Transporthülle erforderlich. Weitere Informationen finden Sie in Dokumente mit Anhängen verarbeiten.

Das Geschäftsobjekt für Nutzinformationen muss außerdem gemäß den Anforderungen der bestimmten ICS-kompatiblen Komponente erstellt werden, die zur Integration mit Business Integration Connect verwendet wird (siehe Tabelle 27). In Tabelle 34 sind die Stellen aufgeführt, an denen Sie detaillierte Informationen zur Erstellung des Geschäftsobjekts für Nutzinformationen für die Übertragung über ein bestimmtes Transportprotokoll finden.

Tabelle 34. Erstellen von Geschäftsobjekten für Nutzinformationen für verschiedene Transportprotokolle
Transportprotokoll Anmerkungen und Einschränkungen Weitere Informationen in
HTTP

Für eine InterChange Server-Version vor 4.2.2 zu verwenden.

Geschäftsobjektdefinitionen für Versionen vor 4.2.2 von ICS über HTTP erstellen
HTTP

Für InterChange Server Version 4.2.2 zu verwenden.

Geschäftsobjektdefinitionen für Version 4.2.2 von ICS über HTTP erstellen
JMS Für Dokumente mit Back-End-Integrationspaket Geschäftsobjektdefinitionen für JMS erstellen
Alle Für Dokumente mit Anhängen Anhangsbezogene Geschäftsobjektdefinitionen erstellen

Konvertierung von Geschäftsobjekten

In der Regel verwendet die ICS-kompatible Komponente einen Data-Handler zur Konvertierung zwischen dem Format des Dokuments und seiner Geschäftsobjektdarstellung. Dieser Data-Handler wird als Payload-Data-Handler bezeichnet. Die ICS-kompatible Komponente muss so konfiguriert werden, dass sie den richtigen Data-Handler für den Inhaltstyp (Content-Type) der Nutzinformationen (payload) aufruft. Gewöhnlich wird der WebSphere Business Integration Data Handler für XML als Payload-Data-Handler konfiguriert, weil er eine Konvertierung zwischen XML-Nachrichten und Geschäftsobjekten ausführt. Sie haben jedoch die Möglichkeit, angepasste Data-Handler für beliebige Nachrichtenformate zu erstellen, für die WebSphere Business Integration Server keinen entsprechenden Data-Handler bereitstellt.

Anmerkung:
Zur Verarbeitung von XML-Nachrichten müssen Sie sicherstellen, dass Sie den WebSphere Business Integration Data Handler für XML der Version 2.3.1 oder einer höheren Version verwenden. Für cXML-Nachrichten müssen Sie den Data Handler für XML Version 2.4.1 oder eine höhere Version verwenden.

Sie müssen sicherstellen, dass die von Ihnen verwendeten Payload-Data-Handler die untergeordneten Metaobjekte ignorieren können, die für das von Ihnen verwendete Transportprotokoll erforderlich sind. Bevor Sie einen Data-Handler (sei es ein von WebSphere Business Integration bereitgestellter oder ein angepasster Data-Handler) verwenden, müssen Sie sicherstellen, dass er Unterstützung für untergeordnete Metaobjekte bietet. Lesen Sie den Abschnitt über den Tag cw_mo_bezeichnung in den anwendungsspezifischen Informationen des Geschäftsobjekts im entsprechenden Abschnitt für Ihr Transportprotokoll (siehe Tabelle 34).

Zur Angabe, welcher Data-Handler zur Konvertierung der Nutzinformationen zu verwenden ist, müssen Sie die folgenden Schritte ausführen:

InterChange Server-Terminologie

Für InterChange Server hängt der Name des Geschäftsobjekts für Nutzinformationen wie folgt von der Kommunikationsrichtung ab:

Geschäftsobjekte für Konfigurationsdaten

Für viele der ICS-kompatiblen Komponenten erstellen Sie Geschäftsobjektdefinitionen, um Konfigurationsdaten darin unterzubringen. Solche Geschäftsobjekte werden häufig als Metaobjekte bezeichnet.

In Tabelle 34 sind die Stellen aufgeführt, an denen Sie detaillierte Informationen zur Erstellung des Datengeschäftsobjekts für die Übertragung über ein bestimmtes Transportprotokoll finden.

Tabelle 35.
Transportprotokoll Zugehörige Komponente Weitere Informationen in
HTTP (an InterChange Server vor Version 4.2.2) Wrapper-Data-Handler

Konfigurationsgeschäftsobjekte für den Wrapper-Data-Handler erstellen

HTTP (an InterChange Server Version 4.2.2) Adapter für HTTP HTTP-Headerinformationen der Transportebene für InterChange Server-Versionen vor 4.2.2 erstellen.
JMS Adapter für JMS JMS-Headerinformationen erstellen
Alle Attachment-Data-Handler Untergeordnetes Metaobjekt für den Attachment-Data-Handler erstellen

Connectors erstellen

Wenn die ICS-kompatible Komponente für Ihr Transportprotokoll ein WebSphere Business Integration Adapter ist, müssen Sie ein Connectorobjekt für diesen Adapter erstellen. Dieses Connectorobjekt stellt eine Instanz des Adapters während der Ausführung dar. Sie können Connectorobjekte im Tool 'System Manager' von InterChange Server erstellen.

Anmerkung:
Informationen zur Erstellung von Connectorobjekten finden Sie im Handbuch System Implementation Guide der Dokumentation zu WebSphere InterChange Server.

Tabelle 36 bietet eine Übersicht über die Stellen, an denen Sie Informationen zur Erstellung von Connectorobjekten je nach dem von Ihnen verwendeten Transportprotokoll finden.

Tabelle 36. Erstellen von Connectorobjekten für verschiedene Transportprotokolle
Transportprotokoll ICS-kompatible Komponente Weitere Informationen in
HTTP

(mit InterChange Server vor Version 4.2.2)

Adapter für XML

(nur Anforderungsverarbeitung)

XML-Connectorobjekt erstellen
HTTP

(mit InterChange Server Version 4.2.2)

Adapter für HTTP HTTP-Connectorobjekt erstellen
JMS Adapter für JMS JMS-Connectorobjekt erstellen

Collaborations erstellen

Der eigentliche Geschäftsprozess, den Sie benötigen, wird innerhalb von InterChange Server durch die Collaboration ausgeführt. Daher muss die entsprechende Collaboration für InterChange Server vorhanden sein, um Ihre Business Integration Connect-Dokumente korrekt zu verarbeiten. Stellen Sie mit Hilfe der folgenden Schritte sicher, dass Sie die entsprechende Collaboration während der Ausführung zur Verfügung steht:

  1. Stellen Sie sicher, dass eine Collaboration-Schablone vorhanden ist, die den benötigten Geschäftsprozess zur Verfügung stellt:
  2. Erstellen Sie ein Collaboration-Objekt und binden Sie die zugehörigen Ports wie folgt:

Tabelle 37 enthält eine Übersicht über die Stellen, an denen Sie Informationen zur Bindung von Collaboration-Objekten je nach dem von Ihnen verwendeten Transportprotokoll finden.

Tabelle 37. Collaboration-Bindung für verschiedene Transportprotokolle
Transportprotokoll ICS-kompatible Komponente Weitere Informationen in
HTTP

(mit InterChange Server vor Version 4.2.2)

Adapter für XML

(nur Anforderungsverarbeitung)

Collaborations zur Kommunikation mit dem Adapter für XML binden
HTTP

(mit InterChange Server Version 4.2.2)

Adapter für HTTP Collaborations zur Kommunikation mit dem Adapter für HTTP binden
JMS Adapter für JMS Collaborations zur Kommunikation mit dem Adapter für JMS binden

Projekt implementieren

Wenn Ihr Benutzerprojekt die Artefakte enthält, die die benötigten Laufzeitkomponenten definieren, müssen Sie es im InterChange Server implementieren. Die Implementierung eines Benutzerprojekts erfolgt über das Tool 'System Manager'.

Copyright IBM Corp. 1997, 2004