Geänderte WSDL aktualisieren

Wenn Sie ein Projekt erstellt haben, das eine WSDL (Web Services Description Language) verwendet, und die WSDL geändert wird, können Sie versuchen, die vorhandene WSDL mit der neuen WSDL zu aktualisieren. Dieser Vorgang wird nachfolgend beschrieben.

Informationen zu diesem Vorgang

Eine Aktualisierung einer WSDL bedeutet, dass alle Entitäten, die mit der WSDL arbeiten, von der Änderung betroffen sein können. Wenn die WSDL zum Beispiel die Ein- und Ausgabeparameter der Operation definiert und sich das Schema, das diese Parameter definiert, in der neuen WSDL ändert, ist es möglich, dass die Knoten, die diese Parameter in den Tasks Eingaben zuordnen und Ausgaben zuordnen der Web-Service-Aktivitäten darstellen, nicht mehr vorhanden und alle Verknüpfungen zu diesen Knoten nicht mehr gültig sind. Sie müssen die Verknüpfungen erneut erstellen, um die Orchestrierung wieder gültig zu machen. Die Aktualisierung einer WSDL erfordert neben der Neuerstellung von Verknüpfungen möglicherweise weitere Änderungen am Projekt. Detaillierte Informationen dazu finden Sie in der nachfolgenden Tabelle. In einigen Fällen wird die neue WSDL nicht wie in den ersten drei Zeilen der folgenden Tabelle beschrieben geladen.
Anmerkung: Die Aktualisierung einer vorhandenen WSDL (wie in den nachfolgenden Schritten beschrieben) unterscheidet sich vom Laden mehrerer WSDLs in ein Projekt, bei dem entweder eine Datei auf die Registerkarte Projekt gezogen wird oder mit der rechten Maustaste auf den WSDL-Ordner auf der Registerkarte Projekt geklickt und die Option Dokument hinzufügen ausgewählt wird. Die Aktualisierung einer WSDL ersetzt die vorhandene WSDL im Projekt, während beim Hochladen derselben Datei auf die Registerkarte Projekt zwei Instanzen der WSDL im Projekt erstellt werden.
Änderung in WSDL Neue WSDL ersetzt die ursprüngliche WSDL? Welche Auswirkung hat dies auf das Projekt?
Neue WSDL ist keine gültige WSDL. Zum Beispiel fehlt der schließende Tag </definitions> am Ende der WSDL. Nein, es erfolgt keine Aktualisierung. Keine, da die neue WSDL nicht geladen wird. Keine Entitäten des Projekts werden aktualisiert.
Durch Hochladen der neuen WSDL zum Ersetzen der vorhandenen ergäbe sich ein ungültiges Projekt. Nein, es erfolgt keine Aktualisierung. Keine, da die neue WSDL nicht geladen wird. Keine Entitäten des Projekts werden aktualisiert.
Versuch, die aktuelle WSDL mit einer anderen WSDL zu aktualisieren, und eine Orchestrierung oder ein Endpunkt im Projekt bezieht sich auf die aktuelle WSDL.
Anmerkung: Sie können mehrere WSDLs in ein Projekt laden.
Nein, es erfolgt keine Aktualisierung. Keine, da die neue WSDL nicht geladen wird. Keine Entitäten des Projekts werden aktualisiert.
Die Service-Binding-Definition der WSDL ist durch Service-, Port- und Positionselemente definiert. Wenn die Werte der Service-, Port- und Positionselemente in der WSDL geändert werden, müssen die Werte für diese Elemente, die im Web-Service-Endpunkt gespeichert sind, aktualisiert werden. Ja, die Aktualisierung erfolgt. Die Werte im Web-Service-Endpunkt werden mit den neuesten, in der WSDL angegebenen Werten aktualisiert. Details zu diesen Elementen siehe Web-Service-Endpunkt erstellen oder bearbeiten.
Der Name einer Operation wird in der WSDL geändert und die Orchestrierung startet diese Operation in einer Aktivität Service aufrufen. Ja, die Aktualisierung erfolgt. Wenn der Name der Operation geändert wird und die Operation von der Aktivität Service aufrufen verwendet wird, wird die erste Operation in der WSDL standardmäßig der Aktivität Service aufrufen zugewiesen. Diese geänderte Zuordnung zur ersten Operation ist möglicherweise nicht das gewünschte Ergebnis. Die Ein- und Ausgabeparameter der ersten Operation in der WSDL unterscheiden sich möglicherweise von denen, die ursprünglich von der Operation angegeben wurden, sodass die Verknüpfungen in den Tasks Eingaben zuordnen und Ausgaben zuordnen vielleicht nicht mehr vorhanden sind. Sie müssen die Aktivität Service aufrufen erneut konfigurieren, um die Orchestrierung wieder gültig zu machen.
Der Name einer der Operationen in der WSDL wird geändert, jedoch startet die Orchestrierung diese Operation in keiner der Aktivitäten Service aufrufen. Ja, die Aktualisierung erfolgt. Wenn der Name der Operation geändert wird und diese Operation von keinen Aktivitäten Service aufrufen verwendet wird, hat diese Änderung an der WSDL keine Auswirkung.
Zusätzliche Elemente <part> werden den Elementen hinzugefügt, die die Ein- oder Ausgabeparameter der Operation definieren. Diese Änderung betrifft jede Projektentität, die diesen Teil der WSDL referenziert. Die folgende Liste enthält mögliche betroffene Entitäten:
  • Eigenständige Zuordnungen
  • Aktivität Map Variables (Variablen zuordnen)
  • Variablen, die auf diesem Teil der WSDL basieren
  • Eine Orchestrierung, die eine Aktivität Service aufrufen enthält, die eine Operation startet, die diesen Nachrichtentyp verwendet. Wie im folgenden Beispiel mit einem Element <message>:
<message name="HelloIn">
	<part name="address" type="xsd:string>
</message>
Das folgende zusätzliche Element <part> wird hinzugefügt:
<message name="HelloIn">
<part name="address" type="xsd:string>
<part name="city" type="xsd:string>
</message>
Ja, die Aktualisierung erfolgt. Da neue Elemente <part> nur dem Element <message> hinzugefügt wurden, hat diese Änderung in der Regel keine Auswirkung auf die vorhandenen Zuordnungen und Variablen, die auf der WSDL basieren. Für das Beispiel der Nachricht <Helloin> hat das Hinzufügen des neuen Elements 'city' keine Auswirkung auf Verknüpfungen zum vorhandenen <part>-Element 'address' in den Tasks Eingaben zuordnen und Ausgaben zuordnen der Aktivität Service aufrufen. Falls erforderlich, können Sie Verknüpfungen zum neuen Element erstellen.
Der Typ eines Elements <part> in einem Element <message>, die die Ein- und Ausgabeparameter der Operation definieren, wird geändert. Diese Änderung betrifft jede Projektentität, die diesen Teil der WSDL referenziert. Die folgende Liste enthält mögliche betroffene Entitäten:
  • Eigenständige Zuordnungen
  • Aktivität Map Variables (Variablen zuordnen)
  • Variablen, die auf diesem Teil der WSDL basieren
  • Eine Orchestrierung, die eine Aktivität Service aufrufen enthält, die eine Operation startet, die diesen Nachrichtentyp verwendet
Ja, die Aktualisierung erfolgt. Alle vorhandenen Verknüpfungen in den Zuordnungen werden nicht entfernt, selbst wenn der Typ vielleicht geändert wurde.
Vorsicht:
Die Typenänderung kann eine Laufzeitauswirkung haben, die potenziell fehlerhafte Ausgabedaten zur Folge hat. Stellen Sie sicher, dass in den Verknüpfungen von Zuordnungen keine Typenkonvertierungen erfolgen, die zur Folge haben, dass bei der Ausführung fehlerhafte Ausgabedaten zurückgegeben werden.
Das Element <message> des Ein- oder Ausgabeparameters der Operation wird geändert.

Diese Änderung betrifft jede Projektentität, die diesen Teil der WSDL referenziert. Die folgende Liste enthält mögliche betroffene Entitäten:

  • Eigenständige Zuordnungen
  • Aktivität Map Variables (Variablen zuordnen)
  • Variablen, die auf diesem Teil der WSDL basieren
  • Eine Orchestrierung, die eine Aktivität Service aufrufen enthält, die eine Operation startet, die diesen Nachrichtentyp verwendet
Ja, die Aktualisierung erfolgt. Verknüpfungen zum Ein- oder Ausgabeparameter, die in der Zuordnung geändert wurden, werden entfernt. Sie müssen die Verknüpfungen zum geänderten Parameter in den Zuordnungen erstellen. Wenn zum Beispiel das Element <message> für den Eingabeparameter der Operation, die von einer Aktivität Service aufrufen aufgerufen wird, geändert wird, werden die Verknüpfungen zu den Knoten in der Task Eingaben zuordnen der Aktivität Service aufrufen entfernt. Sie müssen Verknüpfungen von Variablen zu der neuen Gruppe von Knoten erstellen, die im Fenster 'An Aktivität' der Task Eingaben zuordnen angezeigt werden.