Ausführen des Portkonfigurations-Assistenten
Mit dem Portkonfigurations-Assistenten werden Ports im Orchestrierungs-Designer erstellt und konfiguriert. Einem Port muss ein Porttyp zugeordnet sein. Mit dem Assistenten wird ein vorhandener Porttyp ausgewählt oder ein neuer Porttyp erstellt. Weitere Informationen zu Ports und Porttypen finden Sie unter Verwenden von Ports in Orchestrierungen.
So starten Sie den Assistenten
Klicken Sie mit der rechten Maustaste auf einen Port (auf der Entwurfsoberfläche oder im Fenster Orchestrierungsansicht), und klicken Sie auf Port konfigurieren.
Führen Sie Smarttagelemente aus, deren zugehörige Aktionen dazu führen, dass ein Port erstellt wird.
Auswählen des Befehls Neuer konfigurierter Portparameter im Kontextmenü des Ordners Orchestrierungsparameter im Fenster Orchestrierungsansicht.
So führen Sie den Assistenten aus
Öffnen Sie den Portkonfigurations-Assistenten.
Geben Sie die Portinformationen an. Dazu zeigt der Assistent zu Ihrer Unterstützung verschiedene Seiten an. Nachdem Sie jede Seite abgeschlossen haben, wechseln Sie zur folgenden Seite, indem Sie auf Weiter klicken, oder wechseln Sie zur vorherigen Seite, indem Sie auf Zurück klicken.
Porteigenschaften. Geben Sie einen Namen für den Port ein.
Wählen Sie einen Porttyp aus. Auf dieser Seite wählen Sie zunächst aus, ob Sie einen neuen Porttyp oder einen vorhandenen Porttyp wünschen. Wenn Sie Vorhandenen Porttyp auswählen, verwenden Sie ein Struktursteuerelement, um den vorhandenen Porttyp auszuwählen, der zugewiesen werden soll.
Wenn Sie Neuer Porttyp auswählen, müssen Sie den Namen des Porttyps in das Textfeld Name eingeben oder den vorgeschlagenen Standardnamen akzeptieren. Außerdem wählen Sie das Kommunikationsmuster (unidirektional oder Anforderungsantwort) und gegebenenfalls Zugriffsbeschränkungen für den neuen Porttyp aus.
Portbindung. Auf dieser Seite geben Sie die Kommunikationsrichtung an, die auch als Polarität bezeichnet wird, und den Bindungstyp des Ports.
Die Wahl der Polarität hängt teilweise vom Kommunikationsmuster des Porttyps ab, den Sie auf der vorherigen Seite des Assistenten Porttyp auswählen ausgewählt haben. In der folgenden Tabelle werden Ihre Auswahlmöglichkeiten zusammengefasst:
Portrichtung Kommunikationsmuster Kommunikationsrichtung, die auf der Seite Portbindung ausgewählt wird. Send Unidirektional Ich werde immer Nachrichten an diesem Port senden. Empfangen Unidirektional Ich empfange Nachrichten immer auf diesem Port. Senden/Empfangen Solicit-Response Ich sende eine Anfrage und erhalte eine Antwort. Empfangen/Senden Anforderung-Antwort Ich empfange eine Anforderung und sende eine Antwort. Sie haben die Wahl zwischen vier verschiedenen Bindungstypen: Später angeben, Jetzt angeben, Dynamisch und Direkt. Jede Option zeigt eine andere Auswahl an Konfigurationsoptionen an, wie im Folgenden zusammengefasst.
Später angeben . Wenn Sie diese Optionen auswählen, sind keine weiteren Konfigurationseinstellungen im Assistenten erforderlich, da die Bindungsinformationen nicht zur Entwurfszeit festgelegt werden. Sie werden meist zur Bereitstellungszeit vom Administrator hinzugefügt.
Jetzt angeben . Zur Entwurfszeit können Sie einen URI angeben, der die Entität definiert, an die der Port gebunden werden soll. Außerdem müssen Sie aus einer Liste einen Transporttyp auswählen. Sie haben die Wahl zwischen BizTalk-Message Queuing, FILE, SMTP, HTTP und SOAP. Dies ist eine vorprogrammierte Liste, die zur frühen Bindung im Orchestrierungs-Designer dient; daher sind darin keine anderen Transporttypen verfügbar. Abschließend wählen Sie in einer Liste der verfügbaren Pipelines eine Empfangs- und eine Sendepipeline aus. Die Liste für jede enthält alle Pipelines im aktuellen Projekt sowie die Option zum Auswählen einer Pipeline aus einer Assembly, auf die verwiesen wird, die das Dialogfeld Artefakttyp auswählen anzeigt.
Dynamisch: Diese Option hat ähnliche Optionen wie Jetzt angeben, ist aber nur für einen Sendeport verfügbar. Sie können eine zu verwendende Sendepipeline angeben. Sie können den Port separat in einem Ausdrucks-Shape angeben, sodass er zur Laufzeit zugewiesen wird.
Direkte. . Wenn Sie eine direkte Bindung definieren, können Sie entweder einen Port zum Verbinden angeben (um eingehende Nachrichten in der MessageBox-Datenbank basierend auf Filterausdrücken weiterzuleiten) oder den Port als selbstkorrelierenden Port definieren. Sie können einen Port aus einer Dropdownliste auswählen.
Weitere Informationen finden Sie unter Portbindungen.
Schließen Sie den Assistenten ab. Auf der letzten Seite des Portkonfigurations-Assistenten mit dem Titel Abschluss des Port-Assistenten werden die Optionen angezeigt, die Sie auf den vorherigen Seiten getroffen haben, damit Sie sie überprüfen können, bevor Sie die Änderungen übernehmen. Wenn die Änderungen richtig sind, klicken Sie auf Fertig stellen. Klicken Sie andernfalls auf Zurück , um alle Informationen, die Sie ändern möchten, erneut einzugeben. Navigieren Sie dann erneut durch den Assistenten, und klicken Sie auf Fertig stellen , wenn die auf der letzten Seite angezeigten Informationen den gewünschten Änderungen entsprechen.
Hinweis
Wenn Sie einen neuen Port erstellen und im Assistenten jederzeit vor Abschluss der Portkonfiguration auf Abbrechen klicken, wird der Port nicht erstellt. Wenn Sie den Assistenten zum Ändern eines vorhandenen Ports verwendet haben, werden in diesem Fall alle bisher vorgenommenen Änderungen rückgängig gemacht. Wenn Sie andernfalls im Assistenten auf Abbrechen klicken, wird der Adapter weiterhin erstellt, seine Eigenschaften werden jedoch nicht festgelegt. Sie können die Eigenschaften des Ports manuell im Eigenschaftenfenster des Ports festlegen oder den Assistenten erneut ausführen.