Sdílet prostřednictvím

Úloha webové služby

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Úloha webové služby spustí metodu webové služby. Úlohu webové služby můžete použít pro následující účely:

  • Hodnoty, které metoda webové služby vrací, se zapisují do proměnné. Můžete například získat nejvyšší teplotu dne z metody webové služby a pak tuto hodnotu použít k aktualizaci proměnné použité ve výrazu, který nastaví hodnotu sloupce.

  • Zápis do souboru hodnot, které vrátí metoda webové služby. Seznam potenciálních zákazníků je například možné zapsat do souboru a pak ho použít jako zdroj dat v balíčku, který data před zápisem do databáze vyčistí.

Soubor WSDL

Úloha webové služby používá správce připojení HTTP pro připojení k webové službě. Správce připojení HTTP se konfiguruje odděleně od úlohy webové služby a odkazuje se na tuto úlohu. Správce připojení HTTP určuje nastavení proxy serveru, jako je adresa URL serveru, přihlašovací údaje pro přístup k serveru webových služeb a délka časového limitu. Další informace najdete v tématu Správce připojení HTTP.

Důležité

Správce připojení HTTP podporuje pouze anonymní ověřování a základní ověřování. Nepodporuje ověřování systému Windows.

Správce připojení HTTP může odkazovat na web nebo na soubor WSDL (Web Service Description Language). Adresa URL správce připojení HTTP odkazující na soubor WSDL obsahuje ?WSDL parametr: https://MyServer/MyWebService/MyPage.asmx?WSDLnapříklad .

Soubor WSDL musí být k dispozici místně pro konfiguraci úlohy webové služby pomocí dialogového okna Editor úloh webové služby , které poskytuje aplikace SSIS Designer.

  • Pokud správce připojení HTTP odkazuje na web, musí být soubor WSDL zkopírován ručně do místního počítače.

  • Pokud správce připojení HTTP odkazuje na soubor WSDL, lze soubor stáhnout z webu do místního souboru úlohou webové služby.

Soubor WSDL uvádí metody, které webová služba nabízí, vstupní parametry, které metody vyžadují, odpovědi, které metody vrací, a způsob komunikace s webovou službou.

Pokud metoda používá vstupní parametry, úloha webové služby vyžaduje hodnoty parametrů. Například metoda webové služby, která doporučuje délku lyží, které byste měli zakoupit na základě výšky, vyžaduje, aby byla výška odeslána ve vstupním parametru. Hodnoty parametrů lze poskytnout buď pomocí řetězců definovaných v úkolu, nebo proměnnými definovanými v oboru úkolu nebo nadřazeného kontejneru. Výhodou použití proměnných je, že umožňují dynamicky aktualizovat hodnoty parametrů pomocí konfigurací balíčků nebo skriptů. Další informace najdete v tématu Proměnné služby SSIS (Integration Services) a konfigurace balíčků.

Mnoho metod webové služby nepoužívá vstupní parametry. Například metoda webové služby, která získá jména prezidentů, kteří se narodili v aktuálním měsíci, nebude vyžadovat vstupní parametr, protože webová služba může určit aktuální měsíc místně.

Výsledky metody webové služby lze zapsat do proměnné nebo do souboru. Správce připojení k souborům slouží buď k určení souboru, nebo k zadání názvu proměnné k zápisu výsledků. Další informace naleznete v tématu Správce připojení k souborům a proměnné služby SSIS (Integration Services).

Vlastní zprávy protokolování dostupné v úloze webové služby

Následující tabulka uvádí vlastní položky protokolu, které můžete povolit pro úlohu webové služby. Další informace naleznete v tématu Integrace služeb (SSIS) protokolování.

Položka protokolu Description
WSTaskBegin Úkolem bylo přistoupit k webové službě.
WSTaskEnd Úloha dokončila metodu webové služby.
WSTaskInfo Popisné informace o úkolu

Konfigurace úlohy webové služby

Vlastnosti můžete nastavit prostřednictvím návrháře SSIS nebo programově.

Další informace o vlastnostech, které můžete nastavit v nástroji SSIS Designer, získáte kliknutím na následující téma:

Další informace o tom, jak nastavit tyto vlastnosti v nástroji SSIS Designer, najdete kliknutím na následující téma:

Programová konfigurace úlohy webové služby

Další informace o programovém nastavení těchto vlastností získáte kliknutím na jedno z následujících témat:

Obecná stránka editoru úkolů webových služeb

Chcete-li určit správce připojení HTTP, zadejte umístění souboru WSDL (Web Services Description Language) pomocí stránky Obecné v dialogovém okně Editor úloh Webové služby , popište úlohu Webové služby a stáhněte soubor WSDL.

Možnosti

HTTPConnection
V seznamu vyberte správce připojení nebo klikněte na tlačítko <Nové připojení a> vytvořte nového správce připojení.

Důležité

Správce připojení HTTP podporuje pouze anonymní ověřování a základní ověřování. Nepodporuje ověřování systému Windows.

Související témata:Správce připojení HTTP, Editor Správce připojení HTTP (stránka serveru)

WSDLFile
Zadejte plně kvalifikovanou cestu k souboru WSDL, který je místní pro počítač, nebo klikněte na tlačítko procházet (...) a vyhledejte tento soubor.

Pokud jste již ručně stáhli soubor WSDL do počítače, vyberte tento soubor. Pokud se však soubor WSDL ještě nestáhnul, postupujte takto:

  • Vytvořte prázdný soubor, který má příponu názvu souboru .wsdl.

  • Vyberte tento prázdný soubor pro možnost WSDLFile .

  • Nastavte hodnotu OverwriteWSDLFile na True , aby byl prázdný soubor přepsán skutečným souborem WSDL.

  • Kliknutím na tlačítko Stáhnout WSDL stáhněte skutečný soubor WSDL a přepište prázdný soubor.

    Poznámka:

    Možnost Stáhnout WSDL není povolená, dokud do pole WSDLFile nezadáte název existujícího místního souboru.

Přepsání souboru WSDL
Určuje, zda lze přepsat soubor WSDL pro úlohu webové služby.

Pokud chcete stáhnout soubor WSDL pomocí tlačítka Stáhnout WSDL , nastavte tuto hodnotu na True.

název
Zadejte jedinečný název úlohy webové služby. Tento název se používá jako popisek v ikoně úkolu.

Poznámka:

Názvy úkolů musí být v rámci balíčku jedinečné.

Description
Zadejte popis úlohy webové služby.

Stáhnout WSDL
Stáhněte soubor WSDL.

Toto tlačítko není povoleno, dokud do pole WSDLFile nezadáte název existujícího místního souboru.

Editor úloh webové služby (vstupní stránka)

Pomocí vstupní stránky editoru úloh webové služby zadejte webovou službu, webovou metodu a hodnoty, které chcete webové metodě poskytnout jako vstup. Hodnoty lze zadat buď zadáním řetězců přímo do sloupce Hodnota, nebo výběrem proměnných ve sloupci Hodnota.

Možnosti

Service
Ze seznamu vyberte webovou službu, která se má použít ke spuštění webové metody.

Metoda
Ze seznamu vyberte webovou metodu, aby se úloha spustila.

WebMethodDocumentation
Zadejte popis webové metody nebo klikněte na tlačítko procházet (...) a zadejte popis v dialogovém okně Dokumentace k webové metodě .

název
Vypíše názvy vstupů do webové metody.

Type
Vypíše datový typ vstupů.

Poznámka:

Úloha webové služby podporuje pouze parametry následujících datových typů: primitivní typy, jako jsou celá čísla a řetězce; pole a sekvence primitivních typů; a výčty.

Proměnná
Zaškrtnutím políček použijte proměnné k zadání vstupů.

Hodnota
Pokud jsou zaškrtnutá políčka Proměnná, vyberte proměnné v seznamu a zadejte vstupy; v opačném případě zadejte hodnoty, které se mají použít ve vstupech.

Editor úloh webové služby (výstupní stránka)

Pomocí výstupní stránky dialogového okna Editor úloh webové služby určete, kam se má uložit výsledek vrácený webovou metodou.

Statické možnosti

OutputType
Vyberte typ úložiště, který chcete použít při ukládání výsledků. Tato vlastnost obsahuje možnosti uvedené v následující tabulce.

Hodnota Description
Připojení k souborům Uložte výsledky do souboru. Výběrem této hodnoty se zobrazí dynamická možnost Soubor.
Proměnná Uložte výsledky do proměnné. Výběrem této hodnoty se zobrazí dynamická možnost Proměnná.

Dynamické možnosti výstupního typu

OutputType = Připojení k souboru

File
V seznamu vyberte správce připojení k souborům nebo kliknutím na tlačítko <Nové připojení...> vytvořte nového správce připojení.

Související témata:Správce připojení souborů, Editor Správce připojení souborů

OutputType = proměnná

Proměnná
Vyberte proměnnou v seznamu nebo klikněte na <tlačítko Nová proměnná...> a vytvořte novou proměnnou.

Související témata:Proměnné služby SSIS (Integration Services),Přidání proměnné

Související obsah

Video, Jak volat webovou službu prostřednictvím úlohy webové služby (video SQL Serveru) na technet.microsoft.com.

  • Last updated on