Delen via

Web Service-taak

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De webservicetaak voert een webservicemethode uit. U kunt de webservicetaak voor de volgende doeleinden gebruiken:

  • Schrijven naar een variabele de waarden die een webservicemethode retourneert. U kunt bijvoorbeeld de hoogste temperatuur van de dag verkrijgen via een webservicemethode en deze waarde vervolgens gebruiken om een variabele bij te werken die wordt gebruikt in een expressie waarmee een kolomwaarde wordt ingesteld.

  • Schrijven naar een bestand met de waarden die een webservicemethode retourneert. Een lijst met potentiële klanten kan bijvoorbeeld naar een bestand worden geschreven en het bestand vervolgens worden gebruikt als een gegevensbron in een pakket waarmee de gegevens worden opgeschoond voordat deze naar een database worden geschreven.

WSDL-bestand

De webservicetaak maakt gebruik van een HTTP-verbindingsbeheer om verbinding te maken met de webservice. Het HTTP-verbindingsbeheer wordt afzonderlijk geconfigureerd van de webservicetaak en wordt in de taak verwezen. Het HTTP-verbindingsbeheer geeft de proxy-instellingen voor de server op, zoals de server-URL, referenties voor toegang tot de webserver en time-outlengte. Zie HTTP Connection Manager voor meer informatie.

Belangrijk

Het HTTP-verbindingsbeheer ondersteunt alleen anonieme verificatie en basisverificatie. Windows-verificatie wordt niet ondersteund.

Het HTTP-verbindingsbeheer kan verwijzen naar een website of naar een WSDL-bestand (Web Service Description Language). De URL van de HTTP-verbindingsbeheerder die naar een WSDL-bestand verwijst, bevat de parameter ?WSDL, bijvoorbeeld https://MyServer/MyWebService/MyPage.asmx?WSDL.

Het WSDL-bestand moet lokaal beschikbaar zijn om de webservicetaak te configureren met behulp van het dialoogvenster Webservicetaakeditor dat SSIS Designer biedt.

  • Als het HTTP-verbindingsbeheer verwijst naar een website, moet het WSDL-bestand handmatig naar een lokale computer worden gekopieerd.

  • Als het HTTP-verbindingsbeheer verwijst naar een WSDL-bestand, kan het bestand worden gedownload van de website naar een lokaal bestand door de webservicetaak.

Het WSDL-bestand bevat de methoden die de webservice biedt, de invoerparameters die de methoden vereisen, de antwoorden die de methoden retourneren en hoe u met de webservice kunt communiceren.

Als voor de methode invoerparameters worden gebruikt, zijn voor de webservicetaak parameterwaarden vereist. Een webservicemethode die bijvoorbeeld de lengte van ski's aanbeveelt die u moet aanschaffen op basis van uw hoogte, vereist dat uw hoogte wordt ingediend in een invoerparameter. De parameterwaarden kunnen worden opgegeven door tekenreeksen die zijn gedefinieerd in de taak, of door variabelen die zijn gedefinieerd in het bereik van de taak of een bovenliggende container. Het voordeel van het gebruik van variabelen is dat u de parameterwaarden dynamisch kunt bijwerken met behulp van pakketconfiguraties of scripts. Zie SSIS-variabelen (Integration Services) en pakketconfiguraties voor meer informatie.

Veel webservicemethoden gebruiken geen invoerparameters. Een webservicemethode die bijvoorbeeld de namen ophaalt van presidenten die in de huidige maand zijn geboren, vereist geen invoerparameter omdat de webservice de huidige maand lokaal kan bepalen.

De resultaten van de webservicemethode kunnen worden geschreven naar een variabele of naar een bestand. U gebruikt bestandsverbindingsbeheer om het bestand op te geven of om de naam van de variabele op te geven waarnaar de resultaten moeten worden geschreven. Zie SSIS-variabelen (File Connection Manager en Integration Services) voor meer informatie.

Aangepaste logboekberichten die beschikbaar zijn op de webservicetaak

De volgende tabel bevat de aangepaste logboekvermeldingen die u kunt inschakelen voor de webservicetaak. Zie Integration Services (SSIS) Loggingvoor meer informatie.

Logboekvermelding Description
WSTaskBegin De taak is begonnen met het openen van een webservice.
WSTaskEnd De taak heeft een webservicemethode voltooid.
WSTaskInfo Beschrijvende informatie over de taak.

Configuratie van de webservicetaak

U kunt eigenschappen instellen via SSIS Designer of programmatisch.

Klik op het volgende onderwerp voor meer informatie over de eigenschappen die u in SSIS Designer kunt instellen:

Klik op het volgende onderwerp voor meer informatie over het instellen van deze eigenschappen in SSIS Designer:

Programmatische configuratie van de webservicetaak

Klik op een van de volgende onderwerpen voor meer informatie over het programmatisch instellen van deze eigenschappen:

Webservicetaakeditor (algemene pagina)

Gebruik de pagina Algemeen van het dialoogvenster Taakeditor voor webservices om een HTTP-verbindingsbeheer op te geven, geef de locatie op van het WSDL-bestand (Web Services Description Language) dat door de webservicetaak wordt gebruikt, beschrijf de webservicestaak en download het WSDL-bestand.

Options

HTTPConnection
Selecteer een verbindingsbeheer in de lijst of klik op <Nieuwe verbinding...> om een nieuw verbindingsbeheer te maken.

Belangrijk

Het HTTP-verbindingsbeheer ondersteunt alleen anonieme verificatie en basisverificatie. Windows-verificatie wordt niet ondersteund.

Verwante onderwerpen:HTTP Connection Manager, HTTP Connection Manager Editor (serverpagina)

WSDLFile
Typ het volledig gekwalificeerde pad van een WSDL-bestand dat lokaal is op de computer of klik op de bladerknop (...) en zoek dit bestand.

Als u het WSDL-bestand al handmatig naar de computer hebt gedownload, selecteert u dit bestand. Als het WSDL-bestand echter nog niet is gedownload, voert u de volgende stappen uit:

  • Maak een leeg bestand met de bestandsnaamextensie .wsdl.

  • Selecteer dit lege bestand voor de WSDLFile-optie .

  • Stel de waarde van OverwriteWSDLFile in op True om in te schakelen dat het lege bestand kan worden overschreven met het werkelijke WSDL-bestand.

  • Klik op WSDL downloaden om het werkelijke WSDL-bestand te downloaden en het lege bestand te overschrijven.

    Opmerking

    De optie WSDL downloaden is pas ingeschakeld als u de naam opgeeft van een bestaand lokaal bestand in het vak WSDLFile .

OverschrijvenWSDLFile
Geef aan of het WSDL-bestand voor de webservicetaak kan worden overschreven.

Als u het WSDL-bestand wilt downloaden met behulp van de knop WSDL downloaden, stelt u deze waarde in op Waar.

Naam
Geef een unieke naam op voor de webservicetaak. Deze naam wordt gebruikt als het label in het taakpictogram.

Opmerking

Taaknamen moeten uniek zijn binnen een pakket.

Beschrijving
Typ een beschrijving van de webservicetaak.

WSDL downloaden
Download het WSDL-bestand.

Deze knop is pas ingeschakeld als u de naam opgeeft van een bestaand lokaal bestand in het vak WSDLFile .

Webservicetaakeditor (invoerpagina)

Gebruik de invoerpagina van het dialoogvenster Taakeditor van de webservice om de webservice, de webmethode en de waarden op te geven die als invoer moeten worden opgegeven voor de webmethode. De waarden kunnen worden opgegeven door tekenreeksen rechtstreeks in de kolom Waarde te typen of door variabelen in de kolom Waarde te selecteren.

Options

Service
Selecteer een webservice in de lijst die u wilt gebruiken om de webmethode uit te voeren.

Methode
Selecteer een webmethode in de lijst om de taak uit te voeren.

WebMethodDocumentation
Typ een beschrijving van de webmethode of klik op de bladerknop (...) en typ de beschrijving in het dialoogvenster Documentatie voor webmethoden .

Naam
Hier worden de namen van de invoer voor de webmethode weergegeven.

Typ
Geeft het gegevenstype van de invoer weer.

Opmerking

De webservicetaak ondersteunt alleen parameters van de volgende gegevenstypen: primitieve typen, zoals gehele getallen en tekenreeksen; matrices en reeksen primitieve typen; en opsommingen.

Veranderlijk
Schakel de selectievakjes in om variabelen te gebruiken om invoer te leveren.

Waarde
Als de selectievakjes Variabele zijn ingeschakeld, selecteert u de variabelen in de lijst om de invoer op te geven; anders typt u de waarden die u in de invoer wilt gebruiken.

Webservicetaakeditor (uitvoerpagina)

Gebruik de uitvoerpagina van het dialoogvenster Taakeditor van de webservice om op te geven waar het resultaat moet worden opgeslagen dat door de webmethode wordt geretourneerd.

Statische opties

OutputType
Selecteer het opslagtype dat u wilt gebruiken bij het opslaan van de resultaten. Deze eigenschap bevat de opties in de volgende tabel.

Waarde Description
bestandsverbinding Sla de resultaten op in een bestand. Als u deze waarde selecteert, wordt de dynamische optie Bestand weergegeven.
Veranderlijk Sla de resultaten op in een variabele. Als u deze waarde selecteert, wordt de dynamische optie Variabele weergegeven.

Dynamische opties voor OutputType

OutputType = Bestandsverbinding

bestand
Selecteer een bestandsverbindingsbeheer in de lijst of klik op <Nieuwe verbinding...> om een nieuw verbindingsbeheer te maken.

Verwante onderwerpen:Bestandsverbindingsbeheer, Editor voor Bestandsverbindingsbeheer

OutputType = Variabele

Veranderlijk
Selecteer een variabele in de lijst of klik op <Nieuwe variabele...> om een nieuwe variabele te maken.

Verwante onderwerpen:SSIS-variabelen (Integration Services),variabele toevoegen

Verwante inhoud

Video, Procedure: Een webservice aanroepen met behulp van de webservicetaak (SQL Server-video), op technet.microsoft.com.

  • Last updated on