Webdienst (Task)

Aktualisiert: 17. Juli 2006

Der Task Webdienst führt eine Webdienstmethode aus. Der Task Webdienst kann für folgende Zwecke verwendet werden:

• Schreiben der von einer Webdienstmethode zurückgegebenen Werte in eine Variable. Beispielsweise können Sie die Tageshöchsttemperatur von einer Webdienstmethode abrufen und dann mit diesem Wert eine Variable aktualisieren, die in einem Ausdruck zum Festlegen eines Spaltenwertes verwendet wird.
• Schreiben der von einer Webdienstmethode zurückgegebenen Werte in eine Datei. Beispielsweise kann eine Liste potenzieller Kunden in eine Datei geschrieben werden. Diese Datei kann dann in einem Paket als Datenquelle verwendet werden, mit dem die Daten vor dem Schreiben in eine Datenbank bereinigt werden.

Der Task Webdienst verwendet einen HTTP-Verbindungs-Manager, um eine Verbindung mit dem Webdienst herzustellen. Der HTTP-Verbindungs-Manager wird separat vom Task Webdienst konfiguriert, und im Task wird dann darauf verwiesen. Der HTTP-Verbindungs-Manager gibt die Serverproxyeinstellungen an, wie z. B. den Server-URL, Anmeldeinformationen für den Zugriff auf den Webdiensteserver und die Timeoutlänge. Weitere Informationen finden Sie unter HTTP-Verbindungs-Manager.

Der HTTP-Verbindungs-Manager kann auf eine Website oder eine WSDL-Datei (Web Service Description Language (WSDL) zeigen. Der URL des HTTP-Verbindungs-Managers, der auf eine WSDL-Datei zeigt, enthält den ?WSDL-Parameter, zum Beispiel http://MyServer/MyWebService/MyPage.asmx?WSDL.

Die WSDL-Datei muss lokal verfügbar sein, um den Task Webdienst mithilfe des Dialogfeldes Editor für den Task Webdienst des SSIS-Designers zu konfigurieren.

• Falls der HTTP-Verbindungs-Manager auf eine Website zeigt, muss die WSDL-Datei manuell auf einen lokalen Computer kopiert werden.
• Falls der HTTP-Verbindungs-Manager auf eine WSDL-Datei zeigt, kann mit dem Task Webdienst die Datei von der Website in eine lokale Datei gedownloadet werden.

In der WSDL-Datei sind die Methoden des Webdienstes, die für die Methoden erforderlichen Eingabeparameter, die von den Methoden zurückgegebenen Antworten und die Kommunikationsmethode mit dem Webdienst aufgelistet.

Falls die Methode Eingabeparameter verwendet, erfordert der Task Webdienst Parameterwerte. Beispielsweise muss für eine Webdienstmethode, die anhand Ihrer Größe die zu kaufende Skilänge empfiehlt, Ihre Größe mithilfe eines Eingabeparameters übergeben werden. Die Parameterwerte können entweder über im Task definierte Zeichenfolgen oder über im Bereich des Tasks bzw. im übergeordneten Container definierte Variablen übergeben werden. Die Verwendung von Variablen bietet den Vorteil, dass die Parameterwerte über Paketkonfigurationen oder Skripts dynamisch aktualisiert werden können. Weitere Informationen finden Sie unter SQL Server Integration Services-Variablen und Paketkonfigurationen.

Hinweis:
Der Task Webdienst unterstützt nur Parameter der folgenden Datentypen: primitive Typen wie ganze Zahlen und Zeichenfolgen, Arrays und Sequenzen primitiver Typen sowie Enumerationen.

Viele Webdienstmethoden verwenden keine Eingabeparameter. Beispielsweise ist für eine Webdienstmethode, die die Namen der im aktuellen Monat geborenen Präsidenten abruft, kein Eingabeparameter notwendig, weil der Webdienst den aktuellen Monat lokal bestimmen kann.

Die Ergebnisse der Webdienstmethode können in eine Variable oder eine Datei geschrieben werden. Mit dem Dateiverbindungs-Manager geben Sie entweder die Datei an oder stellen den Namen der Variablen bereit, in die die Ergebnisse geschrieben werden sollen. Weitere Informationen finden Sie unter Dateiverbindungs-Manager und SQL Server Integration Services-Variablen.

Verfügbare benutzerdefinierte Meldungen für die Protokollierung für den Task 'Webdienst'

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge aufgelistet, die für den Task 'Webdienst' aktiviert werden können. Weitere Informationen finden Sie unter Implementieren der Protokollierung in Pakete und Benutzerdefinierte Meldungen für die Protokollierung.

Protokolleintrag	Description
WSTaskBegin	Der Zugriff auf einen Webdienst wurde begonnen.
WSTaskEnd	Eine Webdienstmethode wurde beendet.
WSTaskInfo	Beschreibende Informationen zum Task.

Konfigurieren des Tasks Webdienst

Eigenschaften können Sie mit dem SSIS-Designer oder programmgesteuert festlegen.

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im SSIS-Designer festlegen können:

• Editor für den Task 'Webdienst' (Seite Allgemein)
• Editor für den Task 'Webdienst' (Seite Eingabe)
• Editor für den Task 'Webdienst' (Seite Ausgabe)
• Seite Ausdrücke

Klicken Sie auf das folgende Thema, um weitere Informationen zum Festlegen dieser Eigenschaften im SSIS-Designer zu erhalten:

• Vorgehensweise: Festlegen von Taskeigenschaften

Programmgesteuertes Konfigurieren des Tasks Webdienst

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum programmgesteuerten Festlegen dieser Eigenschaften zu erhalten:

• WebServiceTask

Siehe auch

Konzepte

Integration Services-Tasks
Erstellen einer Paketablaufsteuerung

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
17. Juli 2006	Geänderter Inhalt: Eine Tabelle mit benutzerdefinierten Protokolleinträgen wurde hinzugefügt.
14. April 2006	Geänderter Inhalt: Informationen zum Verwenden von Variablen, um die Werte der Eingabeparameter für Webmethoden bereitzustellen, wurden hinzugefügt.