Konfigurieren des BizTalk-Adapters für Hostanwendungen

Mit dem Dialogfeld " BizTalk Adapter for Host Application Configuration " können Sie Verbindungen mit Remote-IBM-CICS-, IMS- oder iSeries-Systemen definieren und verwalten. Sie wird gestartet, wenn Sie auf das Eigenschaftswertfeld "Verbindungszeichenfolgen " klicken. Sie können den BizTalk-Adapter für die Hostanwendungskonfiguration verwenden, um eine TI .NET-Assembly hinzuzufügen. Sie können sie als Teil der Zuordnung verwenden, um Zuordnungen zu importieren, zu exportieren und zu löschen, Verbindungszeichenfolgen zu bearbeiten und Eigenschaften einer TI .NET-Assembly anzuzeigen.

Die Komponenten des Dialogfelds " Hostanwendungskonfiguration " umfassen eine Symbolleiste, ein Menü, ein Datenraster und einen Ergebnisbereich. Dieses Thema enthält die folgenden Abschnitte, in denen die verschiedenen Aufgaben beschrieben werden, die Sie ausführen können.

Symbolleisten- und Menübefehle

Zuordnungs-Fenster für DataGrid

Zuordnungen erstellen und verwalten

Verbindungszeichenfolgeneinstellungen und -zuordnungen

Upgrade von früheren Versionen des Hostintegrationsservers

Symbolleisten- und Menübefehle

Sie können über die Symbolleisten und kontextabhängigen Menüs auf Befehle zugreifen, die Verbindungszeichenfolgen erstellen und verwalten. Sie können mit der rechten Maustaste auf eine beliebige Stelle im Datenraster klicken, um kontextabhängige Menüs anzuzeigen. Wenn Sie beispielsweise mit der rechten Maustaste auf eine Verbindungszeichenfolge klicken, können Sie Zuordnungen anzeigen, bearbeiten, löschen, importieren und exportieren. Sie können auf die Verbindungszeichenfolge doppelklicken, um sie im Bearbeitungsmodus anzuzeigen. Die ENTF-TASTE löscht das aktuell ausgewählte Element, und die F1-TASTE öffnet die Onlinehilfe.

In der folgenden Liste werden Aktionen beschrieben, die Sie ausführen können:

• Fügen Sie eine TI .NET-Assembly aus dem globalen Assemblycache (GAC) oder mithilfe des lokalen Dateipfads hinzu, um der Zuordnung eine Assembly hinzuzufügen. Die Spalten werden mit den Standardwerten aufgefüllt, die aus der Assembly wiedergegeben werden. Die Standardverbindungszeichenfolge kann nicht verwendet werden, wenn Sie die erforderlichen Werte nicht eingeben.

• Löschen Sie die ausgewählten Zuordnungen. Ein Dialogfeld wird angezeigt, um den Löschvorgang zu bestätigen.

• Bearbeiten Sie den Verbindungszeichenfolgenteil der Zuordnung, wenn eine Zuordnung ausgewählt ist. Starten Sie das Dialogfeld "Verbindungszeichenfolge ", um die Verbindungszeichenfolge zu bearbeiten.

• Exportzuordnungen zu XML ermöglichen das Sichern von Zuordnungen. Sie können sie später mithilfe des Importzuordnungsfeatures wiederherstellen. Mit den Import-/Exportfeatures können Sie Zuordnungen zwischen Endpunkten freigeben.

• Mit Importzuordnungen oder REs können Sie XML importieren, die vom BizTalk-Adapter für das Dialogfeld "Hostanwendungskonfiguration " exportiert werden. Sie können auch RE-Definitionen importieren, die vom TI-Manager exportiert wurden, wenn eine Zuordnung ausgewählt ist.

• Eigenschaften der TI .NET-Assembly anzeigen zeigt die Eigenschaften der Assembly an. Das XML-Tag zeigt den Namen des Eingabe-/Ausgabedokuments an, das diese Assembly unterstützt. Der Name der Methode ist Teil des Tagnamens, wird aber beim Suchen einer Zuordnung nicht verwendet. Alle Eigenschaften sind nur-lesbar.

Abbildung des DataGrid-Fensters

Das Dialogfeld Mapping-DataGrid enthält die folgenden Elemente:

• Zustand (vollständig oder unvollständig). Wenn die Verbindungszeichenfolge Verbindungsinformationen nicht enthält, wird eine Warnung angezeigt, die durch einen roten Kreis mit einem weißen Ausrufezeichen angezeigt wird. Nachdem die fehlenden Informationen hinzugefügt wurden, wird die Warnung ausgeblendet.

• ClassName und Schnittstellenname der TI-Assembly, die als Teil der Abbildung verwendet wird.

• Assembly-Name. Der starke Name der Assembly, wenn die Assembly aus dem GAC geladen wird, oder den vollständigen Pfad zur Assembly, wenn es sich um eine lokale Assembly handelt. Dieses Feld wird automatisch ausgefüllt, wenn eine Assembly hinzugefügt wird und schreibgeschützt ist.

• Die Remoteumgebung definiert die Verbindungszeichenfolge. Dies stellt die Merkmale eines Remotesystems dar, das Anforderungen vom BizTalk Host-Anwendungsadapter empfängt. Die Verbindungszeichenfolge besteht aus dem Remoteumgebungstyp, dem Programmiermodell, der Remotehostidentifikation, dem Netzwerktransport und anderen Einstellungen, die bei der Kommunikation mit dem Remotehost verwendet werden.

• Remoteendpunkt DNS-Name oder IP-Adresse des IBM-Remotehosts.

• Im Ergebnisbereich werden die Werte für die Verbindungszeichenfolge der aktuell ausgewählten Zuordnung angezeigt.

Zuordnungen erstellen und verwalten

In diesem Abschnitt werden Aufgaben beschrieben, die Sie ausführen können.

Hinzufügen von Assemblys zum Erstellen einer Verbindungszeichenfolge

Klicken Sie auf der Symbolleiste auf das Ordnersymbol, und wählen Sie dann "Assemblys aus GAC hinzufügen " oder " Lokale Assembly hinzufügen" aus. Beim Hinzufügen von Assemblys von GAC wird ein Dialogfeld gestartet, in dem alle Assemblys im GAC aufgelistet sind, die Sie auswählen können. Wenn Sie " Lokale Assembly hinzufügen" auswählen, können Sie die lokal installierten Assemblys durchsuchen.

Assemblies können auch mithilfe der Optionen Add GAC oder lokale Assembly hinzufügen aus dem Menü hinzugefügt werden.

Löschen einer Verbindungszeichenfolge

Wählen Sie die zu löschenden Zuordnungen oder Zuordnungen aus. Klicken Sie auf das Symbol [X] auf der Symbolleiste, um die ausgewählten Zuordnungen zu löschen. Es wird ein Dialogfeld angezeigt, sodass Sie den Löschvorgang bestätigen können.

Sie können Zuordnungen auch mithilfe der Option "Zuordnungen löschen " aus dem Menü löschen.

Verbindungszeichenfolge bearbeiten

• Die Verbindungszeichenfolge wird verwendet, um die RE-Instanz zu hydratisieren. Sie wird mit Standardwerten aufgefüllt, wenn eine Assembly angegeben wird. Doppelklicken Sie auf die ausgewählte Zuordnung, wählen Sie "Bearbeiten" aus, oder wählen Sie das Menü "Verbindungszeichenfolge bearbeiten " aus, um das Dialogfeld "Verbindungszeichenfolge " zu starten. Auf diese Weise können Sie die Verbindungszeichenfolge für die angegebene RE bearbeiten. Wenn die erforderlichen Werte nicht eingegeben werden, wird ein Fehlerkennzeichnung angezeigt.

• Das RE-Objekt validiert die mindestens erforderlichen Eigenschaftswerte. Die Zelle "Verbindungszeichenfolge" wird gekennzeichnet, wenn die erforderlichen Eigenschaftswerte nicht festgelegt sind. Erforderliche Eigenschaften werden im Abschnitt "Verbindungszeichenfolgeneinstellungen und -zuordnungen" dieses Themas aufgeführt. Die Überprüfung von RE ist im Umfang beschränkt, und unangemessene Werte können zu TI-Laufzeitfehlern führen.

• Im Dialogfeld werden bearbeitbare und nicht bearbeitbare Eigenschaften in einem Raster angezeigt. Im schreibgeschützten Textfeld unten wird die Verbindungszeichenfolge angezeigt, die basierend auf den im Eigenschaftenraster eingegebenen Werten erstellt wird. Eigenschaften werden basierend auf den öffentlichen Methoden gesammelt, die vom RE-Objekt definiert werden, wobei werte vom Objekt selbst definiert sind. Einige Typkonverter und Eigenschaften-Editoren werden bereitgestellt, um die Bearbeitung von Eigenschaftswerten zu erleichtern.

• In der Remoteumgebung werden Eigenschaften angezeigt, die erforderlich sind, um eine Verbindung mit dem Host herzustellen. Diese werden durch ein Sternchen (*) im Eigenschaftenraster angegeben. Wenn mindestens eine Eigenschaft fehlt, wird im Datenraster ein roter Kreis mit einem weißen Ausrufezeichen angezeigt. Diese Warnung benachrichtigt Sie, dass die fehlenden Eigenschaften zur Laufzeit durch Überschreibungen bereitgestellt werden können.

• Sicherheitseinstellungen werden durch vordefinierte Sicherheitsaufzählungen gesteuert, die mithilfe des OR-Operators kombiniert werden können, um neue Sicherheitseinstellungen zu bilden.

  Die Kennzeichnung "Aus" ist exklusiv für Client, Paket und Benutzer. Aus wird deaktiviert, wenn eine der anderen drei aktiviert ist. Wenn "Aus" aktiviert ist, werden alle anderen drei Optionen deaktiviert.

  Der SSOApplication-Editor wird von einer vorherigen Version mit geringfügigen Änderungen portiert. Sie können eine verbundene Anwendung direkt im Eigenschaftenraster angeben oder den Editor verwenden, um bereits erstellte Anwendungen zu wählen.

Verbindungszeichenfolgeneinstellungen und -zuordnungen

In den folgenden Tabellen werden die unterstützten Eigenschaften angezeigt, die die Hostumgebung und das Programmiermodell definieren. Sternchen geben erforderliche Eigenschaften an.

Die Standardwerte werden von den RE-Objekten selbst festgelegt, und eine eingeschränkte Validierung wird durchgeführt.

SNA-Benutzerdaten

*Pflichtfeld.

SNA-Verknüpfung

*Pflichtfeld.

HTTP-Benutzerdaten

*Pflichtfeld.

HTTP-Link

*Pflichtfeld.

IMS LU6.2

*Pflichtfeld.

IMS Connect

*Pflichtfeld.

TRM-Benutzerdaten/Verknüpfung

*Pflichtfeld.

ELM-Benutzerdaten/Link

*Pflichtfeld.

Verteilter Programmanruf

*Pflichtfeld.

System Z Sockets Benutzerdaten/Verknüpfung

*Pflichtfeld.

System-I Sockets-Benutzerdaten

*Pflichtfeld.

Import-Zuordnungen

Zum Importieren von Zuordnungen, die von BizTalk Adapter für die Hostanwendungskonfiguration exportiert werden, klicken Sie auf das Symbol "Zuordnungen importieren" oder "REs ". Wählen Sie "Zuordnungen importieren" aus, oder wählen Sie " Zuordnungen importieren " im Menü "Datei " aus. Sie können dann nach dem XML-Code suchen, der vom BizTalk-Adapter für die Hostanwendungskonfiguration exportiert wird. Wählen Sie die zu importierende Datei aus. Der Importvorgang überschreibt vorhandene Zuordnungen nicht.

RE-Definition importieren

Verwenden Sie dies, um RE-Definitionen zu importieren, die vom TI-Manager exportiert wurden. Wenn eine Zuordnung ausgewählt ist, klicken Sie auf das Symbol " Zuordnungen importieren" oder "REs ". Wählen Sie "REs importieren" oder im Menü "Datei" die Option "REs importieren" aus. Sie können dann nach dem XML-Code suchen, der vom TI-Manager exportiert wurde. Es wird ein Dialogfeld angezeigt, in dem die RE-Definitionen aufgeführt sind, die Sie auswählen können. Es werden nur RE-Definitionen angezeigt, die dasselbe Programmmodell wie die ausgewählte Zuordnung aufweisen.

Exportzuordnungen

Wenn Sie Zuordnungen zu einer XML-Datei exportieren möchten, klicken Sie auf die Exportzuordnungen zum XML-Symbol , oder wählen Sie " Zuordnungen exportieren " im Menü "Datei " aus. Sie können dann zu dem Speicherort navigieren, an dem die Datei gespeichert werden kann. Sie können diese Datei mithilfe der Importzuordnungsfunktion importieren.

Assemblyeigenschaften

Sie können relevante Eigenschaften der Assembly sowie den XML-Tagnamen des Eingabe-/Ausgabedokuments anzeigen, das von dieser Assembly unterstützt wird. Der Methodenname ist Teil des Tagnamens, wird jedoch beim Suchen einer Zuordnung nicht verwendet. Alle Eigenschaften sind nur-lesbar. Wählen Sie die Zuordnung aus, und klicken Sie dann auf das Assemblyeigenschaftensymbol, oder wählen Sie " Assemblyeigenschaften anzeigen " aus dem Menü aus.

Upgrade von früheren Versionen des Hostintegrationsservers

In diesem Abschnitt wird beschrieben, wie Sie vorhandene BAHA-Anwendungen migrieren, um die Verbindungszeichenfolge zu verwenden:

• Wenn die Standard-RE in BAHA verwendet wurde, exportieren Sie die Konfiguration mit TI Manager, und importieren Sie dann die Konfiguration mithilfe des Dialogfelds "Verbindungszeichenfolgen ".

• Wenn nicht standardmäßige RE verwendet wurde, ordnen Sie das Bereitstellungsobjekt dem neuen RE im TI-Manager zu, und exportieren Sie die Konfiguration im TI-Manager. Importieren Sie die Konfiguration mithilfe des Dialogfelds "Verbindungszeichenfolgen ".

• Sie können keine REs in der BizTalk Server-Verwaltung wechseln, ohne die Verbindungszeichenfolge zu verwenden, da das Dialogfeld " Hosttyp " entfernt wurde.

• Die Überschreibung durch die BizTalk Server-Verwaltung wird nicht unterstützt. Obwohl Sie den Nachrichtenkontext verwenden können, um die RE-Außerkraftsetzung zu erreichen, wird dies nicht empfohlen. Es wird empfohlen, Verbindungszeichenfolgen zu verwenden.

• Wenn eine nicht standardmäßige SSO-Anwendung angegeben ist, können Sie den TI-Manager verwenden, um die RE der nicht standardmäßigen SSO-Anwendung zuzuordnen und weiterhin statische RE zu verwenden. Alternativ können Sie sie in der Verbindungszeichenfolge angeben.

  Importieren von XML-Daten, die vom TI-Manager exportiert wurden

  TI-Manager ist nur erforderlich, wenn Sie eine Migration durchführen. Sie können die Definition von REs- und WIP-Objekten in eine XML-Datei exportieren, die im Dialogfeld "Verbindungszeichenfolgen " importiert werden kann.

Der BizTalk-Adapter für die Hostanwendungskonfiguration verwendet das dynamische RE-Feature, das in Host Integration Server 2009 eingeführt wurde. Bei dynamischem RE können die von der TI-Laufzeit benötigten Hostinformationen direkt vor dem Aufrufen der Methode angegeben werden, solange Hostverbindungsinformationen bekannt sind. Die .NET-Clientassembly muss nicht bereitgestellt und einer vordefinierten RE im TI-Manager zugeordnet werden, bevor die Methoden aufgerufen werden können.

Für BAHA können die Verbindungsinformationen in eine Verbindungszeichenfolge integriert werden, die geparst und auf ein RE-Objekt festgelegt wird, das zur Laufzeit erstellt wird. Informationen zu einer RE können angegeben werden, wenn der Port, der den Hostanwendungsadapter hostet, konfiguriert wird. Sie wird als Teil der portkonfigurationsinformationen gespeichert, die von der BizTalk-Verwaltungseinrichtung verwaltet werden. Bei diesem Ansatz integrieren Sie mithilfe von BAHA die .NET-Anwendung in Hostanwendungen und verwenden nur den TI Designer, um die TI .NET-Clientassemblies zu erstellen. Alle anderen Aufgaben können in BizTalk Server ausgeführt werden.

In der folgenden Tabelle werden die Symbolleistenmenüs und -aktionen beschrieben.

Siehe auch

BizTalk-Adapter für Hostanwendungen