Freigeben über

Webdienst (Task)

  • Artikel

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

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.

WSDL-Datei

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. die Server-URL, Anmeldeinformationen für den Zugriff auf den Webdiensteserver und die Timeoutlänge. Weitere Informationen finden Sie unter HTTP-Verbindungs-Manager.

Wichtig

Der HTTP-Verbindungs-Manager unterstützt nur die anonyme Authentifizierung und die Standardauthentifizierung. Er unterstützt keine Windows-Authentifizierung.

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

Die WSDL-Datei muss lokal verfügbar sein, um den Task Webdienst mithilfe des Dialogfelds 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 heruntergeladen 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 Integration Services-Variablen (SSIS) und Paketkonfigurationen.

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 File Connection Manager und Integration Services-Variablen (SSIS).

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 Integration Services-Protokollierung (SSIS).

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

Konfiguration der Task "Webdienst"

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

Klicken Sie auf das folgende Thema, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im SSIS -Designer festlegen können:

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

Programmgesteuerte Konfiguration des Task "Webdienst"

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

Editor für den Task 'Webdienst' (Seite Allgemein)

Auf der Seite Allgemein des Dialogfelds Editor für den Task 'Webdienst' können Sie einen HTTP-Verbindungs-Manager und den Speicherort der WSDL-Datei (Web Services Description Language) angeben, die der Task „Webdienst“ verwendet, den Task „Webdienst“ beschreiben und die WSDL-Datei herunterladen.

Tastatur

HTTPConnection
Wählen Sie in der Liste einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen neuen Verbindungs-Manager zu erstellen.

Wichtig

Der HTTP-Verbindungs-Manager unterstützt nur die anonyme Authentifizierung und die Standardauthentifizierung. Er unterstützt keine Windows-Authentifizierung.

Verwandte Themen: HTTP-Verbindungs-Manager, HTTP-Verbindungs-Manager-Editor (Seite „Server“)

WSDLFile
Geben Sie den vollqualifizierten Pfad der auf dem Computer lokalen WSDL-Datei an, oder klicken Sie auf die Schaltfläche zum Durchsuchen (…) , um nach dieser Datei zu suchen.

Wenn Sie die WSDL-Datei bereits manuell auf den Computer heruntergeladen haben, wählen Sie diese Datei aus. Wenn die WSDL-Datei jedoch noch nicht heruntergeladen wurde, führen Sie folgende Schritte aus:

  • Erstellen Sie eine leere Datei mit der Dateinamenerweiterung WSDL.

  • Wählen Sie diese leere Datei für die Option WSDLFile aus.

  • Legen Sie den Wert von OverwriteWSDLFile auf True fest, damit die leere Datei mit der tatsächlichen WSDL-Datei überschrieben werden kann.

  • Klicken Sie auf WSDL herunterladen , um die tatsächliche WSDL-Datei herunterzuladen und die leere Datei zu überschreiben.

    Hinweis

    Die Option WSDL herunterladen wird erst aktiviert, wenn Sie den Namen einer vorhandenen lokalen Datei im Feld WSDLFile angeben.

OverwriteWSDLFile
Geben Sie an, ob die WSDL-Datei für den Task Webdienst überschrieben werden kann.

Wenn Sie die WSDL-Datei mithilfe der Schaltfläche WSDL herunterladen herunterladen möchten, legen Sie diesen Wert auf Truefest.

Name
Geben Sie einen eindeutigen Namen für den Task Webdienst an. Dieser Name wird im Tasksymbol als Bezeichnung verwendet.

Hinweis

Tasknamen müssen innerhalb eines Pakets eindeutig sein.

Beschreibung
Geben Sie eine Beschreibung des Tasks Webdienst ein.

WSDL herunterladen
Lädt die WSDL-Datei herunter.

Diese Schaltfläche wird erst aktiviert, wenn Sie den Namen einer vorhandenen lokalen Datei im Feld WSDLFile angeben.

Editor für den Task 'Webdienst' (Seite Eingabe)

Mithilfe der Seite Eingabe des Dialogfelds Editor für den Task 'Webdienst' können Sie den Webdienst, die Webmethode sowie die Werte angeben, die der Webmethode als Eingabe zur Verfügung gestellt werden sollen. Die Werte können entweder durch Eingeben von Zeichenfolgen direkt in die Wert-Spalte oder durch Auswählen von Variablen in der Wert-Spalte bereitgestellt werden.

Tastatur

Service
Wählen Sie aus der Liste einen Webdienst aus, der zum Ausführen der Webmethode verwendet werden soll.

Methode
Wählen Sie für den auszuführenden Task eine Webmethode aus der Liste aus.

WebMethodDocumentation
Geben Sie eine Beschreibung der Webmethode ein, oder klicken Sie auf die Schaltfläche zum Durchsuchen (…) , und geben Sie anschließend in das Dialogfeld Dokumentation der Webmethode die Beschreibung ein.

Name
Führt die Namen der Eingaben in die Webmethode in einer Liste auf.

Typ
Führt die Datentypen der Eingaben in einer Liste auf.

Hinweis

Der Webdiensttask unterstützt nur Parameter der folgenden Datentypen: Grundtypen, wie ganze Zahlen und Zeichenfolgen, Arrays und Sequenzen von Grundtypen sowie Enumerationen.

Variable
Aktivieren Sie die Kontrollkästchen, um Variablen für das Bereitstellen von Eingaben zu verwenden.

Wert
Wenn die Kontrollkästchen für die Variablen aktiviert sind, wählen Sie die Variablen in der Liste aus, um die Eingaben bereitzustellen. Andernfalls geben Sie die Werte ein, die in den Eingaben verwendet werden sollen.

Editor für den Task 'Webdienst' (Seite Ausgabe)

Verwenden Sie die Seite Ausgabe des Dialogfelds Editor für den Task 'Webdienst' , um anzugeben, wo das durch die Webmethode zurückgegebene Ergebnis gespeichert werden soll.

Statische Optionen

OutputType
Wählt den Speichertyp, der beim Speichern der Ergebnisse verwendet werden soll. Diese Eigenschaft besitzt die in der folgenden Tabelle aufgeführten Optionen.

Wert BESCHREIBUNG
File Connection Speichert die Ergebnisse in einer Datei. Wenn Sie diesen Wert auswählen, wird die dynamische Option Dateiangezeigt.
Variable Speichert die Ergebnisse in einer Variablen. Wenn Sie diesen Wert auswählen, wird die dynamische Option Variableangezeigt.

OutputType (dynamische Optionen)

OutputType = File Connection

File
Wählen Sie in der Liste einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen neuen Verbindungs-Manager zu erstellen.

Verwandte Themen: Dateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

OutputType = Variable

Variable
Wählen Sie eine Variable aus der Liste aus, oder klicken Sie auf <Neue Variable>, um eine neue Variable zu erstellen.

Verwandte Themen: Variablen von Integrationsdiensten (SSIS), Hinzufügen von Variablen

Verwandte Inhalte

Video, Vorgehensweise: Aufrufen eines Webdiensts mit dem Task „Webdienst“ (SQL Server-Video) auf technet.microsoft.com.