Verknüpfung von Dienst mit TAA-Modul

PublEdge bietet die Möglichkeit, bestehende Dienste mit bestehenden TAA-Modulen zu verknüpfen. Dadurch es es möglich, die Wsdl- und Cobol-Komponenten für das Einbetten des betreffenden TAA-Moduls in den Dienst über ExpEdge generieren zu lassen.

Damit eine Verknüpfung möglich ist, muss der Dienst folgende Voraussetzungen erfüllen:

• Der WebService muss das Verwendungsmuster „document/literal“ verwenden.
• Die Soap-Aktionen müssen automatisch bestückt werden.
• Jede Operation muss je eine Nachricht als Anfrage und Antwort haben; eine Nachricht darf aber eine leere Inline-Gruppe enthalten, also effektiv leer sein.
• Jede Nachricht wird von genau einer Methode verwendet.
• Jede Nachricht besteht aus genau einem Element. Dies kann ein einfacher oder komplexer Typ sein, oder ein inline-definiertes Element, welches auch leer sein darf.
• Wenn das Element auf einem Webdatentyp basiert, hat dieser den Verbund Sequence.

Wenn der WebService das Verwendungsmuster Bindings"document/literal wrapped" verwendet und die Überprüfung keine Warnungen zeigt, sind die Voraussetzungen i.d.R. erfüllt.

Wenn die Verknüpfung nicht möglich ist, oder die Definition der Verknüpfung unvollständig ist, werden in der Liste Probleme die Problempunkte aufgelistet. Wenn durch ein Problem keine Verknüpfung möglich ist, ist die Zeile durch eine Fehler-Symbol gekennzeichnet, sonst mit einem Warnsymbol:

Die Gruppenbox, die diese Liste enthält, ist zugeklappt, wenn keine Probleme gefunden wurden.

☞ Nähere Informationen zu erkannten Problemen und deren möglicher Behebung

Um einen Webservice mit einem TAA-Modul zu verknüpfen,

1. Wählen Sie über den „…“-Knopf hinter Modul das TAA-Modul aus, mit dem der Dienst verknüpft werden soll.
2. Verknüpfen Sie in der Liste Operationen jede Operation aus dem Dienst mit einer Operation in dem TAA-Modul.
3. Bearbeiten Sie die Zuordnung der Elemente aus Anfrage und Antwort zu TAA-Parametern und -Datenstrukturen.

Wenn Sie bei einer bestehenden Verknüpfung das zugeordnete TAA-Modul ändern, gehen alle Verknüpfungsinformationen verloren, und Sie müssen die gesamte Verknüpfung neu definieren.

Die gängigste Art, Verknüpfungen zu definieren, ist die Kombination von Parameter-Verknüpfung am Dienst und Datenstruktur-Verknüpfung an den verwendeten komplexen Typen: Dadurch wird am Dienst festgelegt, welche Parameterobjekte bestückt werden sollen, und am komplexen Typ, wie die jeweiligen Inhalte in die Datenstruktur des angegebenen Parameters übernommen werden sollen.

Nachdem Sie ein TAA-Modul ausgewählt haben, sollten Sie jeder Operation aus dem Dienst eine Operation in dem TAA-Modul zuordnen.

Die in dem TAA-Modul auslösbaren Operationen werden in einer Comboxbox zur Auswahl angeboten. Die TAA-Operationen können bei der Verknüpfung mehrfach verwendet werden.

Nach Verknüpfung der Operation kann pro Operation angegeben werden, ob und wie die Nachrichten für Anfrage und Antwort verknüpft werden sollen. Es stehen drei Verknüpfungsarten zur Verfügung: Parameter, Leer, oder Keine.

Es ist möglich, für Anfrage und Antwort zu einer Operation unterschiedliche Mappingtypen zu verwenden.

Für jede verknüpfte Operation können Sie jedem Element aus Anfrage und Antwort ein Datenelement aus einem der in dem Modul verwendeten TAA-Objekte zuordnen.

Bei der Auswahl der Parameterobjekte werden in der Combobox alle angezeigt, die in der jeweiligen TAA-Operation des Moduls zur Verfügung stehen.

Wenn es sich bei dem Element um einen einfachen Webdatentyp handelt, können Sie die Verknüpfung zu einem Datenstrukturfeld direkt in der Liste vornehmen. Die in dem gewählten Parameterobjekt verfügbaren Datenelemente werden in einer Combobox zur Auswahl gestellt. Nicht verknüpfte Elemente werden bei der Generierung nicht bestückt. Hierbei wird zur Zeit nicht überprüft, ob der Datentyp des gewählten Datenelements zu dem Typ des Web-Elementes passt.

Wenn es sich bei dem Element um einen komplexen Webdatentyp handelt, muss die Verknüpfung an dem Webdatentyp beschrieben werden.

„Leer“ bewirkt, dass leere Elemente erzeugt werden. Es erfolgt keine Bestückung von Elementen bzw. Feldern.

Es können zu dieser Verknüpfungsart keine weiteren Angaben gemacht werden.

Für Dienste mit einer Verknüpfung Keine kann keine Verknüpfung mit einem TAA-Modul erzeugt werden.

Da in <Typ> anonyme Gruppen verwendet werden, kann keine TAA-Verknüpfung erstellt werden.
In dem angegebenen Typ werden inline-Gruppen verwendet, für kein Name angegeben wurde. Dies kann auch der Typ selbst sein, wenn dieser inline definiert ist. Die Definition sogenannter anonymer Gruppen wird zwar in PublEdge nicht unterstützt, sie können aber in importierten Webservices enthalten sein.

Da für <Typ> ein Basistyp (<Typ>) angegeben ist, kann keine TAA-Verknüpfung erstellt werden.
Da in <Typ> für das inline Element <Elementname> ein Basistyp (<Typ>) angegeben ist, kann keine TAA-Verknüpfung erstellt werden.
Der angegebene Typ basiert auf einem anderen Typ; dies kann angegeben sein durch die Angabe Basistyp bei einem komplexen oder einfachen Typ, oder es kann sich um einen Typ handeln, der inline erweitert wurde. Wenn der Typ inline um weitere Element ergänzt wurde, können sie die Meldung vermeiden, indem Sie den erweiterten Typ durch eine Inline-Gruppe ersetzen und den Typ als ein Bestandteil davon angeben. Die an dem vorgenommenen Erweiterungen werden dann zusätzliche Element an der Inline-Gruppe.

Da für <Typ> der Verbund 'choice' angegeben ist, kann keine TAA-Verknüpfung erstellt werden.
Da in <Typ> für das inline Element <Elementname> der Verbund 'choice' angegeben ist, kann keine TAA-Verknüpfung erstellt werden.
Für Verknüpfung mit TAA-Modulen ist der Verbund Choice nicht unterstützt. Dies gilt sowohl für komplexe Webdatentypen als auch für Inline-Gruppen.Geben Sie statt dessen Sequence oder All an.

Das Verwendungsmodell 'document/literal' ist Voraussetzung für die Verknüpfung mit einem TAA-Modul.
Der Dienst verwendet ein anderes Modell als 'document/literal' (Verwendungsmodell-Angabe im Reiter Bindings; dies ist für die Verknüpfung nicht unterstützt.
Wenn Sie 'document/literal' wählen, und die Checkbox Verwendungsmuster 'document/literal wrapped' überwachen ankreuzen, wird schon bei der Definition des Dienstes überprüft, dass die Vorgaben für dieses Verwendungsmodell eingehalten werden.

Für die Verknüpfung mit einem TAA-Modul muss die <Anfrage|Antwort>nachricht <Nachrichtenname> für die Operation <Operation> genau ein Element enthalten.
In der Struktur, die für die Nachricht definiert wurde, sind auf oberster Baumebene zwei oder mehr Elemente vorhanden. Dies wird nicht unterstützt.
Sie können die Meldung vermeiden, indem Sie auf oberster Ebene eine Inline-Gruppe anlegen, und die benötigten Elemente als Teile davon definieren.

Für die Verknüpfung mit einem TAA-Modul muss die <Anfrage|Antwort>nachricht <Nachrichtenname> für die Operation <Operation> auf ein Element verweisen.
In der Definition der Nachrichtenstruktur muss die Spalte Element einen Wert enthalten. <inline tip>Bei Nutzung des Verwendungsmodells 'document/literal wrapped' muss der Elementname zu dem Namen der Operation passen, in der die Nachricht verwendet wird: Bei Anfrage-Nachrichten muss der Elementname gleich dem Operationsnamen sein, bei Antwortnachrichten muss dem Operationnamen der Suffix 'Response' angefügt werden.

Operation <Operation> ist noch nicht mit einer TAA-Operation verknüpft.
Die angegebene Operation aus dem Dienst wurde noch nicht mit einer TAA-Operation verknüpft. Die Modulverknüpfung ist dennoch möglich, jedoch wird die angegebene Operation bei der Generierung nicht berücksichtigt.

Operation <Operation> ist mit der TAA-Operation <TAA-Operation>verknüpft, welche für das TAA-Modul <Modulename> nicht definiert ist.
Die verknüpfte Operation ist in dem TAA-Modul nicht bekannt. Dieser Fehler kann auftreten, wenn die Operation aus dem TAA-Modul nach Erstellen der Verknüpfung entfernt wurde, oder für eine bestehende Verknüpfung ein anderes Modul ausgewählt wurde, was z.Zt. aber nicht unterstützt ist. Ordnen Sie der Operation aus dem Dienst anhand der Combobox zu TAA-Operation einen gültigen Wert zu.

Operation <Operation> ist als 'solicit/response' definiert, was für die Verknüpfung mit einem TAA-Modul nicht möglich ist.
Bei Webservices wird als Schnittstellen-Typ u.a. unterschieden zwischen Request-Response und Solicit-Response. Zur Zeit wird in PublEdge nur Request-Response unterstützt.