Mit der Clientsimulatorsicht können Sie die Clients in Schnittstellen, Connectoragenten und Zugriffsclients von IBM WebSphere InterChange Server emulieren. Diese Sicht stellt Schnittstellen zur Verfügung, mit denen Verbindungen zwischen Clients und Servern hergestellt und Geschäftsobjektanforderungen erstellt und gesendet werden können. Außerdem ermöglicht sie das Antworten mit Geschäftsobjektantworten.
In den folgenden Abschnitten werden Möglichkeiten zum Anzeigen und Schließen der Clientsimulatorsichten beschrieben.
Die Spalte "Standardschnittstellenposition" in Tabelle 29 enthält die Sichten, dessen Standardpositionen in der Schnittstelle durch die in der Spalte "Nummer der Clientsimulatorsicht" aufgeführten Clientsimulatorsichten überlagert werden.
Tabelle 29. Standardpositionen der Clientsimulatorsichten
Nummer der Clientsimulatorsicht | Standardschnittstellenposition |
---|---|
Testconnector 1 | Testumgebungsnavigator |
Testconnector 2 | Gliederung |
Testconnector 3 | Eigenschaften |
Testconnector 4 | Abhängigkeit |
Testconnector 5 | Testumgebungsnavigator |
Testconnector 6 | Gliederung |
Testconnector 7 | Eigenschaften |
Testconnector 8 | Abhängigkeit |
Testconnector 9 | Testumgebungsnavigator |
Verwenden Sie eine der folgenden Methoden, um Clientsimulatorsichten für die Connectors und Zugriffsclients in der Schnittstelle anzuzeigen, die Sie momentan testen:
In Tabelle 29 sind die Standardschnittstellenpositionen aufgeführt, in denen die verschiedenen Clientsimulatorsichten angezeigt werden.
Verwenden Sie eine der folgenden Methoden, um Clientsimulatorsichten zu schließen:
Sie müssen Clientsimulatorsichten mit dem Server verbinden, um einen Connector als Teil eines Tests einer Schnittstelle zu emulieren.
Wenn Sie die Clientsimulatorsicht verwenden, können Sie einen Connector entweder mit der Definition im Repository oder mit einer Konfigurationsdatei emulieren. Sie können die Clientsimulatorsicht auch zum Emulieren eines Zugriffsclients verwenden.
Beachten Sie, dass Sie zum Verbinden von Agenten mit dem Server auch die Task-Manager-Sicht verwenden können. Weitere Informationen finden Sie in Tabelle 25.
Führen Sie einen der folgenden Schritte aus, um mit der Repositorydefinition des Connectors eine Verbindung zum Server herzustellen:
Gehen Sie wie folgt vor, um unter Verwendung einer Konfigurationsdatei eine Verbindung zum Server herzustellen:
Klicken Sie auf den Abwärtspfeil in der rechten Ecke der Titelleiste der Clientsimulatorsicht, und wählen Sie Server > Verbinden aus, um einen Zugriffsclient zu emulieren.
Verwenden Sie die folgenden Hinweise, um festzustellen, ob ein Clientsimulator eine Verbindung zum Server hergestellt hat:
Weitere Informationen zum Statusteilfenster finden Sie unter Statusteilfenster verwenden.
Weitere Informationen zum Eingabeteilfenster finden Sie unter Eingabeteilfenster verwenden.
Um die Verbindung eines Servers zu einem Clientsimulator zu trennen, der einen Connector emuliert, klicken Sie in der rechten Ecke der Titelleiste der Clientsimulatorsicht auf den Abwärtspfeil, und wählen Sie Server > Trennen aus.
Die Verbindung zwischen einer Clientsimulatorsicht und dem Server wird auch getrennt, wenn Sie die Sicht schließen. Die einzige Möglichkeit, um eine Verbindung eines Servers zu einer Clientsimulatorsicht zu trennen, die einen Zugriffsclient emuliert, besteht darin, die Clientsimulatorsicht zu schließen. Weitere Informationen zum Schließen von Clientsimulatorsichten finden Sie unter Clientsimulatorsichten schließen.
Die Clientsimulatorsicht verfügt über mehrere Teilfenster, die Sie zum Simulieren des Verhaltens eines Connectors oder eines Zugriffsclients verwenden.
Sie verwenden das Eingabeteilfenster der Clientsimulatorsicht, um mit Geschäftsobjektanforderungen zu arbeiten und um diese zu senden. Sie können Geschäftsobjektinstanzen erstellen, Daten zu deren Attributen hinzufügen und diese als Anforderungen senden. Normalerweise verwenden Sie das Eingabeteilfenster beim Arbeiten mit einer Clientsimulatorsicht, die einen Quellenclient in einer Schnittstelle emuliert.
In Abbildung 83 wird das Eingabeteilfenster für eine Clientsimulatorsicht angezeigt, in der ein Quellenconnector emuliert wird.
Abbildung 83. Eingabeteilfenster der Clientsimulatorsicht
Sie verwenden das Ergebnisteilfenster in der Clientsimulatorsicht, um mit empfangenen Geschäftsobjektanforderungen zu arbeiten und um Geschäftsobjektantworten zu senden. Normalerweise verwenden Sie das Ergebnisteilfenster beim Arbeiten mit einer Clientsimulatorsicht, die einen Zielclient in einer Schnittstelle emuliert.
In Abbildung 84 wird das Ergebnisteilfenster für eine Clientsimulatorsicht angezeigt, in der ein Zielconnector emuliert wird.
Abbildung 84. Ergebnisteilfenster der Clientsimulatorsicht
Das Statusteilfenster enthält Nachrichten zur Ausführung der Clientsimulatorsicht. Wenn ein Connector beispielsweise erfolgreich eine Verbindung zum Server hergestellt hat, wird die Nachricht [AppConnector: Der Connector wurde wiederhergestellt] im Statusteilfenster ausgegeben.
Sie verwenden das Statusteilfenster hauptsächlich, um zu überprüfen, ob der Clientsimulator eine Verbindung zum Server hergestellt hat und um die Fehlerbehebung durchzuführen. Wenn Sie z. B. von einer Clientsimulatorsicht aus eine Geschäftsobjektanforderung senden und es für den Geschäftsobjekttyp keine Subskription gibt, wird im Statusteilfenster eine Nachricht angezeigt. Diese kann Ihnen bei der Suche nach der Ursache behilflich sein, warum eine Geschäftsobjektanforderung nicht im Ergebnisteilfenster einer Clientsimulatorsicht angezeigt wird, die einen Zielclient in einer Schnittstelle emuliert.
In Abbildung 85 wird das Statusteilfenster für eine Clientsimulatorsicht dargestellt.
Abbildung 85. Statusteilfenster der Clientsimulatorsicht
Sie können eine Clientsimulatorsicht so anordnen, dass die Eingabe-, Ergebnis- und Statusteilfenster gleichzeitig, übereinander gestaffelt, angezeigt werden. Diese Sicht kann hilfreich sein, wenn eine Clientsimulatorsicht einen Client emuliert, der sowohl für die Ereignisbenachrichtigung als auch für die Anforderungsverarbeitung verantwortlich ist.
Führen Sie einen der folgenden Schritte aus, um die Teilfenster der Clientsimulatorsicht vertikal anzuordnen:
In Abbildung 86 werden die Teilfenster der Clientsimulatorsicht in vertikaler Anordnung dargestellt.
Abbildung 86. Teilfenster der Clientsimulatorsicht vertikal anordnen
Sie können eine Clientsimulatorsicht so anordnen, dass die Eingabe-, Ergebnis- und Statusteilfenster gleichzeitig, von links nach rechts angeordnet, angezeigt werden. Diese Sicht kann hilfreich sein, wenn eine Clientsimulatorsicht einen Client emuliert, der sowohl für die Ereignisbenachrichtigung als auch für die Anforderungsverarbeitung verantwortlich ist.
Führen Sie einen der folgenden Schritte aus, um die Teilfenster der Clientsimulatorsicht horizontal anzuordnen:
In Abbildung 87 werden die Teilfenster der Clientsimulatorsicht in horizontaler Anordnung dargestellt.
Abbildung 87. Teilfenster der Clientsimulatorsicht horizontal anordnen
Anforderungsgeschäftsobjekte sind Objekte, die Sie von einer Clientsimulatorsicht aus senden, wenn diese einen Connector emuliert, der die Quelle der Ereignisse ist, die eine Schnittstelle auslösen. Beim Arbeiten mit Anforderungsgeschäftsobjekten erstellen Sie eine Geschäftsobjektinstanz, füllen diese mit Daten und senden die Anforderung.
Gehen Sie wie folgt vor, um eine neue Geschäftsobjektinstanz zu erstellen:
Wenn ein Quellenclient ein Anforderungsgeschäftsobjekt im asynchronen Modus sendet, erwartet dieser kein Antwortgeschäftsobjekt zurück. Wenn ein Anforderungsgeschäftsobjekt zugeteilt wurde, hat der Quellenclient seine Aufgabe erfüllt. Das Antwortgeschäftsobjekt wird normalerweise über den Integrationsbroker verarbeitet. Der Standardmodus für eine Clientsimulatorsicht ist der asynchrone Modus.
Gehen Sie wie folgt vor, um ein Geschäftsobjekt asynchron zu senden:
Wenn ein Quellenclient ein Anforderungsgeschäftsobjekt synchron sendet, erwartet er ein Antwortgeschäftsobjekt vom Integrationsbroker zurück, nachdem sämtliche Zielanwendungen die Anforderung verarbeitet haben.
Die Geschäftsobjektanforderung wird an den konfigurierten Port des Collaboration-Objekts gesendet, das zur Verarbeitung ausgewählt wurde.
Im Stapelbetrieb ermöglicht Ihnen die Clientsimulatorsicht, die Anzahl der Instanzen eines bestimmten Geschäftsobjekts anzugeben, das Sie senden möchten. Außerdem können Sie ein Attribut des Objekts der obersten Ebene (z. B. ein Primärschlüsselattribut) angeben, das für jede Instanz einen eindeutigen Wert erhalten soll. Die Clientsimulatorsicht kopiert das Geschäftsobjekt so oft, wie Sie angegeben haben, erhöht den Wert des einzelnen Attributs, das Sie für jede Instanz angegeben haben und sendet dann die Instanzen. Mit dieser Option können Sie schnell und einfach eine große Anzahl von Geschäftsobjekten erstellen.
Wenn das ausgewählte Attribut ein Schlüsselfeld ist, das an dynamischen Querverweisen als Teil einer Identitätsbeziehung beteiligt ist, müssen Sie sicherstellen, dass der Anfangswert und alle folgenden Werte eindeutig sind. Andernfalls schlägt die Querverweislogik fehl, was wiederum zu einem Fehlschlagen der Anforderungsgeschäftsobjekte führt.
Um sicherzustellen, dass die Werte eindeutig sind, können Sie Relationship Manager verwenden bzw. wie folgt SQL-Anweisungen für die Tabelle der Beziehungsteilnehmer ausführen.
Gehen Sie wie folgt vor, um Geschäftsobjekte im Stapelbetrieb zu senden:
Das ausgewählte Attribut muss normalerweise ein Attribut sein, das das Geschäftsobjekt eindeutig kennzeichnet, z. B. als Primärschlüssel.
Die Clientsimulatorsicht generiert die von Ihnen angegebene Anzahl von Geschäftsobjekten, die alle identisch sind, bis auf das eine angegebene Attribut, dessen Wert für alle Instanzen erhöht wird.
In Abbildung 88 wird eine Konfiguration für den Stapelbetrieb dargestellt, in der Folgendes gilt:
Abbildung 88. Geschäftsobjektanforderungen im Stapelbetrieb senden
Sie können beim Erstellen einer Geschäftsobjektanforderung und beim Bearbeiten einer empfangenen Geschäftsobjektanforderung Werte für Geschäftsobjektattribute festlegen. Diese Anforderung kann dann als Antwort zurückgegeben werden.
Um Werte für die Attribute eines Geschäftsobjekts festzulegen, das Sie als Anforderung senden möchten, müssen Sie das Eingabeteilfenster der Clientsimulatorsicht verwenden. Weitere Informationen finden Sie unter Eingabeteilfenster verwenden.
Verwenden Sie das Fenster Antwortgeschäftsobjekt, um die Attributwerte eines Geschäftsobjekts festzulegen, das Sie als Antwort senden möchten. Weitere Informationen finden Sie unter Antwortgeschäftsobjekte bearbeiten.
Sie können einen Wert für ein einfaches Attribut angeben, indem Sie im Eingabeteilfenster bzw. im Fenster Antwortgeschäftsobjekt in der Spalte Wert auf die Zelle des Attributs klicken und den Wert eingeben.
Sie können eine Instanz eines untergeordneten Geschäftsobjekts hinzufügen, indem Sie im Eingabeteilfenster bzw. im Fenster Antwortgeschäftsobjekt mit der rechten Maustaste auf das Attribut klicken, das für das untergeordnete Objekt steht, und anschließend im Kontextmenü Instanz hinzufügen auswählen.
Neben dem Attribut, das für das untergeordnete Geschäftsobjekt steht, wird ein Pluszeichen (+) hinzugefügt, um anzuzeigen, dass mindestens ein untergeordnetes Geschäftsobjekt vorhanden ist. Wenn Sie das untergeordnete Objektattribut erweitern, werden für jede Instanz nummerierte Einträge angezeigt. Neben den einzelnen Instanzen stehen ebenfalls Pluszeichen (+). Sie können die Instanzen erweitern und Werte für ihre Attribute festlegen.
Um weitere untergeordnete Geschäftsobjekte hinzuzufügen, klicken Sie mit der rechten Maustaste auf das Attribut, das das untergeordnete Objekt repräsentiert, und wählen Sie im Kontextmenü Instanz hinzufügen aus.
Um eine Instanz eines untergeordneten Geschäftsobjekts zu entfernen, klicken Sie mit der rechten Maustaste auf die Instanz, und wählen Sie im Kontextmenü Instanz entfernen aus.
Um alle Instanzen eines untergeordneten Geschäftsobjekts zu entfernen, klicken Sie mit der rechten Maustaste auf das Attribut, das das untergeordnete Geschäftsobjekt repräsentiert, und wählen Sie im Kontextmenü Alle Instanzen löschen aus.
Sie können das Verb eines untergeordneten Geschäftsobjekts festlegen, um die Auswirkungen des Werts auf den Geschäftsprozess zu testen. Diese Methode kann hilfreich sein, wenn Sie Fehler in der Logik beheben, die mit Querverweisen auf untergeordnete Objekte arbeitet.
Um das Verb einer untergeordneten Geschäftsobjektinstanz festzulegen, klicken Sie mit der rechten Maustaste auf diese Instanz, und wählen Sie im Kontextmenü Verb festlegen aus. Wenn Sie zur Auswahl eines Verbs aufgefordert werden, wählen Sie das gewünschte Verb aus und klicken Sie auf OK.
Klicken Sie auf den Abwärtspfeil in der rechten Ecke der Titelleiste der Clientsimulatorsicht, und wählen Sie Bearbeiten > Geschäftsobjekt zurücksetzen aus, um die Attribute einer Geschäftsobjektanforderung auf ihre Standardwerte zurückzusetzen.
Sie können die Attribute einer Geschäftsobjektantwort auf ihre Standardwerte zurücksetzen, indem Sie in der Funktionsleiste des Fensters Antwortgeschäftsobjekt auf die Schaltfläche Das Geschäftsobjekt auf die Standardeinstellung zurücksetzen klicken.
Klicken Sie auf den Abwärtspfeil in der rechten Ecke der Titelleiste der Clientsimulatorsicht, und wählen Sie Bearbeiten > Geschäftsobjektinhalt löschen aus, um die Werte der Attribute einer Geschäftsobjektanforderung zu löschen.
Sie können die Werte der Attribute einer Geschäftsobjektantwort löschen, indem Sie in der Funktionsleiste des Fensters Antwortgeschäftsobjekt auf die Schaltfläche Die Geschäftsobjektwerte löschen klicken.
Antwortgeschäftsobjekte sind Objekte, die Sie von einer Clientsimulatorsicht aus senden, wenn diese einen Connector emuliert, der der Empfänger von Geschäftsobjektanforderungen in einer Schnittstelle ist. Zur Arbeit mit Anforderungsgeschäftsobjekten zählt das Bearbeiten von Werten in der Geschäftsobjektinstanz und das Senden einer Antwort an den Server.
Wenn Sie eine Geschäftsobjektanforderung erstellen und senden, wie unter Mit Geschäftsobjektanforderungen in der Clientsimulatorsicht arbeiten beschrieben, und diese von der Schnittstelle erfolgreich verarbeitet wurde, wird das Geschäftsobjekt im Ergebnisteilfenster beliebiger Zielconnectors in der Schnittstelle angezeigt. In Abbildung 84 wird ein Ergebnisteilfenster dargestellt, in dem eine Geschäftsobjektanforderung empfangen wurde.
Im Abschnitt Antwortgeschäftsobjekte bearbeiten finden Sie eine Beschreibung zur Bearbeitung einer empfangenen Geschäftsobjektanforderung. Im Abschnitt Antwortgeschäftsobjekte senden finden Sie eine Beschreibung zum Senden der Instanz als Antwort.
Wenn Sie in einer Clientsimulatorsicht, die einen Zielclient in einer Schnittstelle emuliert, eine Geschäftsobjektanforderung empfangen, können Sie die Werte der Attribute bearbeiten. Sie können z. B. eindeutige Werte für Primärschlüsselattribute, die an Beziehungen beteiligt sind, zur Verfügung stellen. Außerdem können Sie den Wert anderer Attribute zum Testen von Zuordnungs- oder Collaborationlogik ändern. Dabei fällt die Antwort in Abhängigkeit von den genauen Werten im Geschäftsobjekt unterschiedlich aus. Gehen Sie wie folgt vor, um die Werte von Geschäftsobjektattributen festzulegen:
Die Möglichkeit, gespeicherte Daten in eine Geschäftsobjektanforderung zu importieren, ist dann äußerst hilfreich, wenn Sie ein Antwortgeschäftsobjekt mit Daten füllen müssen, bevor Sie es als Antwort senden. Damit Sie nicht für jedes Attribut, das Antwortdaten erfordert, die Werte bei jedem Test manuell eingeben müssen, können Sie nach Eingabe der Werte das Geschäftsobjekt exportieren und bei zukünftigen Tests die gespeicherten Daten wieder importieren.
Nachdem Sie ein Anforderungsgeschäftsobjekt bearbeitet haben (sofern eine Bearbeitung überhaupt notwendig ist), senden Sie es als Antwort an den Server zurück.
In Tabelle 30 werden die Antwortoptionen und die zugehörigen Connector-Rückkehrcodes für die C++- und Java-Connectors aufgeführt.
Detaillierte Informationen zu den Rückkehrcodes der C++- und Java-Connectors finden Sie in den Handbüchern Connector Development
Guide for C++ und Connector Development Guide for Java Server.
Tabelle 30. Antworttypen der Clientsimulatorsicht und Connector-Rückkehrcodes.
Antworttyp der Clientsimulatorsicht | Rückkehrcode von C++-Connector | Rückkehrcode von Java-Connector |
---|---|---|
Erfolg | BON_SUCCESS | SUCCESS |
Fehler | BON_FAIL | FAIL |
Mehrere Treffer | BON_MULTIPLE_HITS | MULTIPLE_HITS |
Abrufen nach Inhalt - Fehler | 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:
Sie können eine Geschäftsobjektinstanz, die Sie im Eingabeteilfenster erstellt haben, speichern, damit sie immer dann verfügbar ist, wenn die Clientsimulatorsicht zum Emulieren dieser spezifischen Connectordefinition geöffnet wird. Sie können die Instanz im Feld für die Geschäftsobjektinstanz nach Namen auswählen, wenn Sie nicht den gesamten Prozess zur Erstellung einer neuen Anforderung durchlaufen möchten.
Klicken Sie auf den Abwärtspfeil in der rechten Ecke der Titelleiste der Clientsimulatorsicht, und wählen Sie Bearbeiten > Alle Geschäftsobjekte speichern aus, um die momentan im Feld für die Geschäftsobjektinstanz aufgelisteten Geschäftsobjektinstanzen zu speichern.
Das Geschäftsobjekt wird ohne Erweiterung in einer Datei mit dem Namen der Geschäftsobjektinstanz in einem Verzeichnis gespeichert, das den Namen des Geschäftsobjekttyps trägt. Dieses Verzeichnis wiederum befindet sich in einem Verzeichnis mit der Erweiterung .bos im Verzeichnis für das Testprojekt, in dem die Testeinheit definiert wurde. Die Datei wird im selben Format gespeichert, das auch vom Testconnector und von Map Designer verwendet wird. Somit kann die Datei auch zum Testen in diesen Tools verwendet werden.
Klicken Sie auf den Abwärtspfeil auf der rechten Seite der Titelleiste der Clientsimulatorsicht, und wählen Sie Bearbeiten > Geschäftsobjekt löschen aus, um eine Geschäftsobjektinstanz aus der Clientsimulatorsicht zu löschen.
Sie können eine Geschäftsobjektinstanz in eine Datei exportieren, um Daten bequem zu archivieren und um diese mit der technischen Unterstützung gemeinsam zu verwenden. Die Datei mit den Testdaten wird mit der Erweiterung .bo gespeichert und kann sowohl mit dem Testconnector und Map Designer als auch mit der integrierten Testumgebung zu Testzwecken verwendet werden.
Gehen Sie wie folgt vor, um eine Geschäftsobjektinstanz aus dem Eingabeteilfenster der Clientsimulatorsicht zu exportieren:
Gehen Sie wie folgt vor, um eine Geschäftsobjektinstanz aus dem Fenster Antwortgeschäftsobjekt zu exportieren, während eine Geschäftsobjektantwort im Ergebnisteilfenster bearbeitet wird:
Sie können eine Datei mit Testdaten des Geschäftsobjekts importieren, die unter Map Designer bzw. dem Testconnector gespeichert bzw. aus der integrierten Testumgebung exportiert wurde.
Gehen Sie wie folgt vor, um eine Geschäftsobjektinstanz in das Eingabeteilfenster der Clientsimulatorsicht zu importieren:
Gehen Sie wie folgt vor, um eine Geschäftsobjektinstanz in das Fenster Antwortgeschäftsobjekt zu importieren, während eine Geschäftsobjektantwort im Ergebnisteilfenster bearbeitet wird:
Eine Clientsimulatorsicht kann zwei Geschäftsobjekte desselben Typs miteinander vergleichen und die Attribute anzeigen, die einen unterschiedlichen Wert haben. Sie können diese Funktion verwenden, um an unterschiedlichen Punkten der Ausführung einer Transaktion Änderungen an einem Geschäftsobjekt anzuzeigen. Sie können z. B. ein Geschäftsobjekt, das an den Server gesendet wurde, nach der Verarbeitung durch den Server und der Rückgabe an den Quellenconnector vergleichen. Gehen Sie wie folgt vor, um zwei Geschäftsobjektinstanzen miteinander zu vergleichen:
Zum Transport der Datenausgabe von Geschäftsobjekten wird CORBA verwendet. Da diese Lösung bei bei großen Datenvolumen zu Problemen führen kann, speichert der Server die aktuellen Geschäftsobjektdaten lokal zwischen und benachrichtigt den Client nur über Metadaten. Aufgrund der überschaubaren Größe dieses Aufrufs können die Prüfpunkte des Geschäftsobjekts schnell aktualisiert werden. Die auf dem Server zwischengespeicherten Daten werden gelöscht, wenn ein Neustart des Servers erfolgt oder die integrierte Testumgebung eine entsprechende Anforderung sendet.
Der Datentransport von Geschäftsobjekten ist nur für ferne Server vorgesehen. Für lokale Server sollte das lokale Dateisystem gemeinsam genutzt werden, um ein optimales Leistungsverhalten zu erreichen. Bei aktiviertem Geschäftsobjekt-Trace teilt die integrierte Testumgebung lokalen Servern die Dateisystemposition mit. Handelt es sich um einen fernen Server, ist die Dateisystemposition leer.