Nachricht hinzufügen

Nachrichten sind eine abstrakte Definition der übertragenen Daten. Eine Nachricht besteht aus logischen Abschnitten; dabei ist jeder einer Definition in einem bestimmten Typsystem zugeordnet. WSDL-Nachrichten sind Objekte der obersten Ebene, auf die die Eingabe, die Ausgabe oder die Fehlerelemente (innerhalb eines Porttyps) einer Operation verweisen können.

Sie können eine Nachricht mithilfe der Ansicht 'Gliederung' erstellen, indem Sie mit der rechten Maustaste auf den Ordner Nachrichten und anschließend auf Nachricht hinzufügen klicken.

Gehen Sie wie folgt vor, um eine neue Nachricht für Ihre Eingabe, Ihre Ausgabe oder für Ihr Fehlerelement zu erstellen:

  1. IKlicken Sie in der Entwurfssicht mit der rechten Maustaste auf Ihre Eingabe, Ihre Ausgabe oder auf Ihr Fehlerelement, und klicken Sie auf Nachricht festlegen > Neue Nachricht.
  2. Geben Sie den Namen der Nachricht im Teilfenster Allgemein in der Ansicht 'Eigenschaften' ein. Dieser Name muss hinsichtlich aller in dem einschließenden WSDL-Dokument definierten Nachrichten eindeutig sein.
  3. Die neue Nachricht wird in der Entwurfssicht innerhalb des Porttyps angezeigt.

Hinweis: Auf Nachrichten wird innerhalb eines Porttyps verwiesen (insbesondere durch die Eingabe, die Ausgabe oder Fehlerobjekte einer Operation). Die Eingabe, die Ausgabe oder Fehlerobjekte in einem Binding verweisen nicht auf Nachrichten. Daher können Sie keine neue Nachricht erstellen, wenn Sie mit der rechten Maustaste auf eine Eingabe, eine Ausgabe oder ein Fehlerobjekt in einem Binding klicken (diese Bindings werden auch als Eingabe-, Ausgabe- bzw. Fehlerbinding bezeichnet).

Tipp: Sie können auch eine neue Nachricht für Ihre Eingabe, Ihre Ausgabe oder Ihr Fehlerelement unter Verwendung der Ansicht 'Gliederung' erstellen. Klicken Sie im Ordner Porttypen mit der rechten Maustaste auf Ihr Element, und klicken Sie auf Nachricht festlegen > Nachricht hinzufügen. Daraufhin wird Ihre Nachricht in der Ansicht 'Gliederung' im Ordner Nachrichten angezeigt.

Eine Nachricht wiederverwenden

Gehen Sie wie folgt vor, um eine neue Nachricht für Ihre Eingabe, Ihre Ausgabe oder für Ihr Fehlerelement wiederzuverwenden:
  1. Klicken Sie in der Entwurfssicht mit der rechten Maustaste auf Ihre Eingabe, Ihre Ausgabe oder auf Ihr Fehlerelement, und klicken Sie auf Nachricht festlegen > Vorhandene Nachricht.
  2. Geben Sie im Feld Name einen Suchbegriff ein, mit dem die Liste gefiltert werden kann, oder lassen Sie das Feld frei, um alle Namen anzuzeigen.
  3. Sie können den Bereich der Liste ändern, indem Sie eine der folgenden Optionen auswählen:
    • Arbeitsbereich: Listet die in Ihrem Arbeitsbereich verfügbaren Nachrichten auf.
    • Einschließendes Projekt: Listet die in dem Projekt, das Ihre Datei enthält, verfügbaren Nachrichten auf.
    • Aktuelle Ressource: Listet die in Ihrer Datei verfügbaren Nachrichten auf.
    • Arbeitssets: Listet die in einer angegebenen Gruppe von Dateien verfügbaren Nachrichten auf. Wenn Sie ein Arbeitsset angeben möchten, müssen Sie auf Auswählen klicken. Sie können Dateien aus einem vorhandenen Arbeitsset auswählen, oder ein neues Arbeitsset erstellen. Wenn Sie die Dateien ausgewählt haben, klicken Sie auf OK.
  4. Es werden die vorhandenen Nachrichten aufgeführt. Wählen Sie ein Binding aus, und klicken Sie auf OK.

Eine Nachricht importieren

Wenn Sie eine vorhandene Nachricht für Ihre Eingabe, Ihre Ausgabe oder für Ihr Fehlerelement importieren möchten, müssen Sie die folgenden Schritte ausführen:
  1. Klicken Sie in der Entwurfssicht mit der rechten Maustaste auf Ihre Eingabe, Ihre Ausgabe oder auf Ihr Fehlerelement, und klicken Sie auf Nachricht festlegen > Vorhandene Nachricht.
  2. Geben Sie im Feld Name einen Suchbegriff ein, mit dem die Liste gefiltert werden kann, oder lassen Sie das Feld frei, um alle Namen anzuzeigen.
  3. Sie können eine Nachricht importieren, indem Sie eine der folgenden Optionen auswählen:
    • Arbeitsbereich: Listet die in Ihrem Arbeitsbereich verfügbaren Nachrichten auf.
    • Einschließendes Projekt: Listet die in dem Projekt, das Ihre Datei enthält, verfügbaren Nachrichten auf.
    • Arbeitssets: Listet die in einer angegebenen Gruppe von Dateien verfügbaren Nachrichten auf. Wenn Sie ein Arbeitsset angeben möchten, müssen Sie auf Auswählen klicken. Sie können Dateien aus einem vorhandenen Arbeitsset auswählen, oder ein neues Arbeitsset erstellen. Wenn Sie die Dateien ausgewählt haben, klicken Sie auf OK.
  4. Es werden die Nachrichten aufgeführt. Wählen Sie ein Binding aus, und klicken Sie auf OK.
Sie können nun Abschnitte zu Ihrer Nachricht hinzufügen. Abschnitte stellen einen flexiblen Mechanismus zur Beschreibung des logisch-abstrakten Inhalts einer Nachricht dar. Weitere Informationen hierzu finden Sie unter Einer Nachricht einen Abschnitt hinzufügen.