Mit Geschäftsobjekten arbeiten

Wenn Sie testen wollen, ob eine Schnittstelle für Geschäftsprozesse korrekt entwickelt wurde, müssen Sie prüfen, ob Geschäftsobjekte erfolgreich ausgetauscht und verarbeitet werden können. Im nachfolgenden Abschnitt werden die folgenden Operationen beschrieben:

Mit Anforderungsgeschäftsobjekten arbeiten

Anforderungsgeschäftsobjekte sind diejenigen Geschäftsobjekte, die Sie von Test Connector aus senden, wenn dieser einen Connector emuliert, bei dem es sich um die Quelle der Ereignisse handelt, mit denen eine Schnittstelle ausgelöst wird. Das Arbeiten mit Anforderungsgeschäftsobjekten umfasst das Erstellen einer Geschäftsobjektinstanz, das Füllen dieser Instanz mit Daten und das Senden der Anforderung.

Anforderungsgeschäftsobjekte erstellen

Gehen Sie wie folgt vor, um in Test Connector ein neues Geschäftsobjekt zu erstellen:

  1. Wählen Sie im Teilfenster "Unterstützte Geschäftsobjekte" den Namen des Geschäftsobjekts, das Sie erstellen wollen, im Dropdown-Menü Geschäftsobjekttyp aus.
  2. Klicken Sie neben dem Feld Geschäftsobjektinstanz auf Erstellen.
  3. Sobald der Dialog "Neue Instanz" aufgerufen wurde, geben Sie im Feld Namen eingeben einen Namen für die Instanz ein.
  4. Wählen Sie im Dropdown-Menü Verb das gewünschte Verb aus.
  5. Wählen Sie im Dropdown-Menü Locale des Geschäftsobjekts die gewünschte Locale aus.
  6. Geben Sie Werte für die einfachen Attribute und die untergeordneten Geschäftsobjekte im Objekt der höchsten Ebene an (siehe Werte für Geschäftsobjektattribute festlegen).

    Abb. 57 zeigt ein Geschäftsobjekt namens Caesar_Customer mit dem Verb Create, dem Locale en_US, angegebenen Werten für alle einfachen Attribute und einer einzelnen Instanz des untergeordneten Geschäftsobjekts Caesar_Address.

    Abbildung 57. Geschäftsobjekt mit Daten füllen
  7. Klicken Sie auf OK.

Anforderungsgeschäftsobjekte senden

Nachdem Sie ein Geschäftsobjekt erstellt oder geladen und Werte für seine Attribute angegeben haben, stehen Ihnen verschiedene Möglichkeiten zur Verfügung, um das Geschäftsobjekt als Anforderung an InterChange Server Express zu senden.

Anforderungsgeschäftsobjekte asynchron senden

Wenn ein Quellenconnector ein Anforderungsgeschäftsobjekt im asynchronen Modus sendet, erwartet er nicht, ein Antwortgeschäftsobjekt zurück zu erhalten. Sobald das Anforderungsgeschäftsobjekt versendet wurde, ist die Aufgabe des Quellenconnectors in der Transaktion erfüllt. Das Antwortgeschäftsobjekt wird normalerweise durch InterChange Server Express verarbeitet. Der Standardmodus für Test Connector ist der asynchrone Modus.

Gehen Sie wie folgt vor, um ein Geschäftsobjekt asynchron zu senden:

  1. Wählen Sie in der Menüleiste die Optionen Anforderung > Modus > Asynchron aus.
    Anmerkung:
    Test Connector verwendet standardmäßig den Modus "Asynchron". Daher müssen Sie den vorstehenden Schritt nur dann ausführen, wenn Sie zuvor synchrone Anforderungen vom Connector aus gesendet haben. Außerdem müssen Sie den Modus nicht vor dem Senden jeder Anforderung festlegen.
  2. Wählen Sie in der Menüleiste die Optionen Anforderung > Senden aus.

Falls in der Connectordefinition InterChange Server Express als Broker angegeben ist, wird die Geschäftsobjektanforderung zur Verarbeitung an den Server gesendet.

Ist in der Connectordefinition einer der unterstützten Nachrichtenbroker oder WebSphere Application Server angegeben, wird das Geschäftsobjekt in die Warteschlange gestellt, die in der Standardeigenschaft RequestQueue angegeben ist.

Anforderungsgeschäftsobjekte synchron senden

Wenn ein Quellenconnector ein Anforderungsgeschäftsobjekt im synchronen Modus sendet, erwartet er, vom Integrationsbroker ein Antwortgeschäftsobjekt zurück zu erhalten, nachdem alle Zielanwendungen die Anforderung verarbeitet haben. Im synchronen Modus stellt Test Connector das Antwortgeschäftsobjekt in die Warteschlange, die in der Eigenschaft des Connectors für die Warteschlange für synchrone Anforderungen angegeben ist. Der Standardmodus für Test Connector ist der asynchrone Modus.

  1. Wählen Sie in der Menüleiste die Optionen Anforderung > Modus > Synchron aus, um Test Connector in den synchronen Modus zu versetzen.
  2. Wählen Sie in der Menüleiste die Optionen Anforderung > Senden aus.
  3. Falls in der Connectordefinition InterChange Server Express als Broker angegeben ist, wird der Dialog "Collaboration auswählen" aufgerufen. Wählen Sie im Dropdown-Menü Collaboration die Collaboration aus, an die das Geschäftsobjekt gesendet werden soll, und klicken Sie auf OK.

Die Geschäftsobjektanforderung wird nun an den konfigurierten Port des Collaboration-Objekts gesendet, das für die Verarbeitung ausgewählt wurde.

Anforderungsgeschäftsobjekte im Stapelbetrieb senden

Im Stapelbetrieb von Test Connector können Sie die Anzahl der Instanzen eines bestimmten Geschäftsobjekts angeben, die Sie senden wollen, sowie ein Attribut im Objekt der höchsten Ebene - beispielsweise ein Primärschlüsselattribut - das für jede Instanz auf einen eindeutigen Wert gesetzt werden soll. Test Connector kopiert das Geschäftsobjekt so häufig wie von Ihnen angegeben und erhöht dabei den Wert des von Ihnen angegebenen Attributs. Anschließend werden alle Geschäftsobjekte gesendet. Dank dieser Option können Sie schnell und ohne großen Aufwand eine große Anzahl von Geschäftsobjekten erstellen.

Falls es sich bei dem ausgewählten Attribut um ein Schlüsselfeld handelt, das im Rahmen einer Identitätsbeziehung an dynamischen Querverweisen beteiligt ist, müssen Sie sicherstellen, dass der Anfangswert und alle folgenden Werte eindeutig sind. Andernfalls schlägt die Querverweislogik fehl, was zu einem Fehlschlagen der Anforderungsgeschäftsobjekte führt.

Die Eindeutigkeit der Werte können Sie durch die Verwendung von Relationship Manager oder durch die Ausführung von SQL-Anweisungen für die Tabelle der Beziehungsteilnehmer sicherstellen. Dies ist nachfolgend beschrieben.

Gehen Sie wie folgt vor, um Geschäftsobjekte im Stapelbetrieb zu senden:

  1. Wählen Sie im Dropdown-Menü Geschäftsobjekttyp den Namen des Geschäftsobjekts aus, das Sie senden möchten.
  2. Wählen Sie in der Menüleiste die Optionen Anforderung > Stapel senden aus.
  3. Wählen Sie im Fenster "Stapelbetrieb" das gewünschte Verb im Dropdown-Menü Verb aus.
  4. Wählen Sie im Dropdown-Menü Locale des Geschäftsobjekts die gewünschte Locale aus.
  5. Wählen Sie in der Liste Attribut das Attribut im Geschäftsobjekt der höchsten Ebene aus, das bei jeder Geschäftsobjektanforderung im Stapel erhöht werden soll.

    Das ausgewählte Attribut sollte in der Regel ein Attribut sein, mit dem das Geschäftsobjekt eindeutig gekennzeichnet wird, beispielsweise ein Primärschlüssel.

  6. Geben Sie im Feld Anfangswert den Anfangswert für das Attribut an, der belastet werden soll.
  7. Geben Sie im Feld Anzahl der Geschäftsobjekte an, wie viele Instanzen des Geschäftsobjekts erstellt und gesendet werden sollen.
  8. Klicken Sie auf OK.

    Test Connector generiert die von Ihnen angegebene Anzahl der Geschäftsobjekte. Alle Instanzen sind, mit Ausnahme des angegebenen Attributs, dessen Wert bei jeder Instanz erhöht wird, identisch.

    Die Geschäftsobjektanforderung wird nun zur Verarbeitung an InterChange Server Express gesendet.

Abb. 58 zeigt eine Konfiguration für den Stapelbetrieb mit den folgenden Merkmalen:

Abbildung 58. Fenster "Stapelbetrieb"

Werte für Geschäftsobjektattribute festlegen

Die folgenden Abschnitte beschreiben die unterschiedlichen Verfahren, mit denen Sie die Werte von einfachen Attributen und Verbundattributen in einer Geschäftsobjektinstanz festlegen können:

Werte für einfache Attribute festlegen

Zur Angabe eines Wertes für ein einfaches Attribut klicken Sie in der Spalte Wert auf dessen Zelle, und geben Sie einen Wert ein.

Untergeordnete Geschäftsobjekte hinzufügen

Eine Instanz eines untergeordneten Geschäftsobjekts können Sie hinzufügen, indem Sie mit der rechten Maustaste auf das Attribut klicken, das das untergeordnete Objekt darstellt, und anschließend im Kontextmenü die Option Instanz hinzufügen auswählen.

Neben dem Attribut, das das untergeordnete Geschäftsobjekt darstellt, wird ein Pluszeichen (+) hinzugefügt und auf diese Weise angegeben, dass mindestens eine Instanz des untergeordneten Geschäftsobjektes vorhanden ist. Wenn Sie das Attribut für das untergeordnete Objekt erweitern, werden für jede Instanz nummerierte Einträge angezeigt. Neben den einzelnen Instanzen werden ebenfalls Pluszeichen (+) angezeigt, damit Sie diese erweitern und Werte für die Attribute festlegen können.

Wenn Sie weitere Instanzen untergeordneter Geschäftsobjekte hinzufügen wollen, klicken Sie mit der rechten Maustaste auf das Attribut, das das untergeordnete Objekt darstellt, und wählen Sie im Kontextmenü die Option Instanz hinzufügen aus.

Anmerkung:
Falls die Eigenschaft Karte des Attributs, das auf das untergeordnete Geschäftsobjekt verweist, auf den Wert 1 gesetzt ist (und somit ein Attribut mit Einzelkardinalität angibt), können Sie lediglich eine Instanz des untergeordneten Objekts hinzufügen.

Untergeordnete Geschäftsobjekte entfernen

Eine Instanz eines untergeordneten Geschäftsobjekts können Sie entfernen, indem Sie mit der rechten Maustaste auf die Instanz klicken und anschließend im Kontextmenü die Option Instanz entfernen auswählen.

Wenn Sie alle Instanzen eines untergeordneten Geschäftsobjekts entfernen wollen, klicken Sie mit der rechten Maustaste auf das Attribut, das das untergeordnete Geschäftsobjekt darstellt, und wählen Sie anschließend im Kontextmenü die Option Alle Instanzen löschen aus.

Verb eines untergeordneten Geschäftsobjekts festlegen

Sie können das Verb eines untergeordneten Geschäftsobjekts festlegen, um die Auswirkungen dieses Wertes auf den Geschäftsprozess zu testen. Dies kann bei der Fehlerbehebung für Logik hilfreich sein, an der Querverweise auf untergeordnete Objekte beteiligt sind.

Zur Festlegung des Verbs für die Instanz eine untergeordneten Geschäftsobjekts klicken Sie mit der rechten Maustaste auf die Instanz, und wählen Sie dann im Kontextmenü die Option Verb festlegen aus. Nachdem die Bedienerführung "Verb auswählen" aufgerufen wurde, wählen Sie das gewünschte Verb aus, und klicken Sie auf OK.

Symbolleiste für Antwortgeschäftsobjekt verwenden

Sie können die Attribute eines Geschäftsobjekts, das von einem Zielconnector empfangen wurde, ändern, bevor Sie es als Antwort senden. Die Symbolleiste im Dialog "Antwortgeschäftsobjekt", die Sie zu diesem Zweck einsetzen, enthält mehrere Schaltflächen, mit denen die Werte des Geschäftsobjekts festgelegt werden können. Weitere Informationen finden Sie unter Antwortgeschäftsobjekte bearbeiten.

Geschäftsobjekt speichern

Wenn Sie ein Geschäftsobjekt in Test Connector speichern, können Sie es bei späteren Tests einsetzen, mit der technischen Unterstützung (bei der Fehlerbehebung) gemeinsam nutzen oder als Antwortdaten verwenden. Sie können jedes beliebige Geschäftsobjekt speichern, einschließlich solcher Objekte, die Sie selbst erstellt haben oder die als Anforderungen im Fenster "Test Connector" eines Zielconnectors angezeigt werden. In der Standardeinstellung werden Geschäftsobjekte in einer Datei mit der Erweiterung für Geschäftsobjekte (.bo) gespeichert.

Es empfiehlt sich, ein spezielles Verzeichnis oder eine spezielle Verzeichnisstruktur für Dateien mit Testdaten zu erstellen, in denen den einzelnen Schnittstellen bzw. Connectors jeweils eigene Unterverzeichnisse zugewiesen sind. Diese Struktur erleichtert die Suche nach den erforderlichen Dateien und macht Tests effizienter. Außerdem ist es sinnvoll, der Datei mit den Testdaten für ein Geschäftsobjekt den gleichen Namen wie der eigentlichen Geschäftsobjektdefinition zu geben.

Anforderungsgeschäftsobjekte speichern

Gehen Sie wie folgt vor, um eine Geschäftsobjektinstanz zu speichern, die Sie als Anforderung erstellt haben:

  1. Wählen Sie das Geschäftsobjekt aus, das Sie speichern wollen.
  2. Wählen Sie in der Menüleiste die Optionen Bearbeiten > Geschäftsobjekt speichern aus.
  3. Navigieren Sie zum gewünschten Verzeichnis, und geben Sie im Feld Dateiname einen Namen für die Datei ein.
  4. Klicken Sie auf Speichern.

Antwortgeschäftsobjekt speichern

Gehen Sie wie folgt vor, um eine Geschäftsobjektinstanz zu speichern, die durch eine Zielinstanz von Test Connector empfangen wurde und als Antwort gesendet werden soll:

  1. Wählen Sie die Geschäftsobjektinstanz im Teilfenster "Liste der Geschäftsobjektanforderungen" aus.
  2. Wählen Sie in der Menüleiste die Optionen Anforderung > Antwort bearbeiten aus.
  3. Klicken Sie auf Geschäftsobjekt speichern.
  4. Navigieren Sie zum gewünschten Verzeichnis, und geben Sie im Feld Dateiname einen Namen für die Datei ein.
  5. Klicken Sie auf Speichern.

Geschäftsobjekt laden

Gehen Sie wie folgt vor, um ein Geschäftsobjekt zu laden, das in einer Datei gespeichert wurde:

  1. Wählen Sie in der Menüleiste von Test Connector die Optionen Bearbeiten > Geschäftsobjekt laden aus.
  2. Navigieren Sie zur Datei mit den Testdaten für das Geschäftsobjekt, und öffnen Sie die Datei.
  3. Sobald der Dialog "Neue Instanz" aufgerufen wurde, geben Sie im Feld Namen eingeben einen Namen für die Instanz ein.
  4. Klicken Sie auf OK.

Geschäftsobjekt löschen

Wählen Sie in der Menüleiste die Optionen Bearbeiten > Geschäftsobjekt löschen aus, um ein Geschäftsobjekt aus Test Connector zu löschen.

Anmerkung:
Bei dieser Aktion wird nur das Geschäftsobjekt aus Test Connector entfernt. Die Unterstützung des Connectors für die Geschäftsobjektdefinition wird nicht entfernt.

Anforderungsgeschäftsobjekt akzeptieren

Wenn Sie ein Geschäftsobjekt als Anforderung senden, wird das Geschäftsobjekt (unter der Voraussetzung, dass die Transaktion nicht fehlgeschlagen ist) im Teilfenster "Liste der Geschäftsobjektanforderungen" aller Instanzen von Test Connector angezeigt, die Zielconnectors in der Schnittstelle emulieren.

Nachdem Sie das Anforderungsgeschäftsobjekt akzeptiert haben, können Sie es bei Bedarf bearbeiten (siehe Antwortgeschäftsobjekte bearbeiten).

Mit Antwortgeschäftsobjekten arbeiten

Antwortgeschäftsobjekte sind diejenigen Geschäftsobjekte, die Sie von Test Connector aus senden, wenn dieser einen Connector emuliert, bei dem es sich um den Empfänger von Geschäftsobjektanforderungen in einer Schnittstelle handelt. Das Arbeiten mit Anforderungsgeschäftsobjekten umfasst das Bearbeiten der Werte in der Geschäftsobjektinstanz und das Senden der Antwort zurück an den Broker.

Antwortgeschäftsobjekte bearbeiten

Wenn Sie eine Geschäftsobjektanforderung in einer Zielinstanz von Test Connector empfangen, werden Sie häufig die Werte der Attribute bearbeiten wollen. Beispielsweise kann es sein, dass Sie eindeutige Werte für Primärschlüsselattribute angeben wollen, die an Beziehungen beteiligt sind. Denkbar ist auch eine Änderung des Wertes von anderen Attributen, um die Zuordnung oder die Collaboration-Logik zu testen, die abhängig von den exakten Werten im Geschäftsobjekt unterschiedlich reagiert. Gehen Sie wie folgt vor, um die Werte von Geschäftsobjektattributen festzulegen:

  1. Wählen Sie die Geschäftsobjektinstanz im Teilfenster "Liste der Geschäftsobjektanforderungen" aus.
  2. Wählen Sie in der Menüleiste die Optionen Anforderung > Antwort bearbeiten aus.
  3. Gehen Sie wie folgt vor, um die Attribute des Geschäftsobjekts zu bearbeiten:

Antwortgeschäftsobjekt senden

Nachdem Sie ein Anforderungsgeschäftsobjekt akzeptiert haben, bearbeiten Sie das Geschäftsobjekt bei Bedarf, und senden es als Antwort zurück.

In Tabelle 27 sind die Antwortoptionen von Test Connector und ihre entsprechenden Connectorrückkehrcodes für C++- und für Java-Connectors angegeben.

Tabelle 27. Antworttypen von Test Connector und Connectorrückkehrcodes
Antworttyp von Test Connector C++-Connectorrückkehrcode Java-Connectorrückkehrcode
Erfolg BON_SUCCESS SUCCESS
Fehlgeschlagen BON_FAIL FAIL
Mehrfachtreffer BON_MULTIPLE_HITS MULTIPLE_HITS
Abrufen nach Inhalt fehlgeschlagen BON_FAIL_RETRIEVE_BY_CONTENT RETRIEVEBYCONTENT_FAILED
Nicht gefunden BON_BO_DOES_NOT_EXIST BO_DOES_NOT_EXIST
Wert doppelt BON_VALDUPES VALDUPES

Gehen Sie wie folgt vor, um auf ein Anforderungsgeschäftsobjekt zu antworten:

  1. Wählen Sie das Geschäftsobjekt im Teilfenster "Liste der Geschäftsobjektanforderungen" aus.
  2. Wählen Sie in der Menüleiste die Optionen Anforderung > Antworten aus.
  3. Wählen Sie im Untermenü Antworten einen Eintrag aus.

Geschäftsobjektinstanzen vergleichen

Test Connector kann zwei Geschäftsobjekte desselben Typs vergleichen und die Attribute mit unterschiedlichen Werten anzeigen. Mit Hilfe dieser Funktion können Sie Änderungen an einem Geschäftsobjekt an verschiedenen Punkten der Ausführung einer Transaktion anzeigen (beispielsweise könnten Sie ein Geschäftsobjekt, das an den Integrationsbroker gesendet wurde, mit dem Zustand des Geschäftsobjekts vergleichen, nachdem es durch den Integrationsbroker aktualisiert wurde). Gehen Sie wie folgt vor, um zwei Geschäftsobjekte zu vergleichen:

  1. Erstellen Sie eine Instanz des Anforderungsgeschäftsobjekts. Gehen Sie hierzu nach den Anweisungen unter Anforderungsgeschäftsobjekte erstellen oder Geschäftsobjekt laden vor.
  2. Wählen Sie die Instanz des Antwortgeschäftsobjekts, mit der Sie die Instanz des Anforderungsgeschäftsobjekts vergleichen wollen, im Teilfenster "Liste der Geschäftsobjektanforderungen" aus.
  3. Wählen Sie in der Menüleiste die Optionen Bearbeiten > Geschäftsobjekte vergleichen aus.

    Test Connector öffnet daraufhin das Fenster "Geschäftsobjekte vergleichen". Dieses Fenster enthält eine Tabelle, in der die Attribute angezeigt werden, die in den beiden Geschäftsobjekten unterschiedliche Werte aufweisen. Abb. 59 zeigt einen Vergleich zwischen zwei Geschäftsobjektinstanzen.

    Abbildung 59. Fenster "Geschäftsobjekte vergleichen"
  4. Klicken Sie auf OK, um das Fenster zu schließen.

Copyright IBM Corp. 2004, 2005