Udostępnij przez

Zadanie usługi sieci Web

Dotyczy:SQL Server SSIS Integration Runtime w ramach usługi Azure Data Factory

Zadanie usługi sieci Web wykonuje metodę usługi sieci Web. W następujących celach można użyć zadania Usługa sieci Web:

  • Zapisywanie w zmiennej wartości zwracanych przez metodę usługi sieci Web. Można na przykład uzyskać najwyższą temperaturę dnia z metody usługi sieci Web, a następnie użyć tej wartości, aby zaktualizować zmienną używaną w wyrażeniu, które ustawia wartość kolumny.

  • Zapisywanie w pliku wartości zwracanych przez metodę usługi sieci Web. Na przykład lista potencjalnych klientów może zostać zapisana w pliku, a następnie użyta jako źródło danych w pakiecie, który czyści dane przed zapisaniem w bazie danych.

Plik WSDL

Zadanie Usługa sieci Web używa menedżera połączeń HTTP do nawiązania połączenia z usługą sieci Web. Menedżer połączeń HTTP jest konfigurowany oddzielnie od zadania usługa sieci Web i jest przywołyny w zadaniu. Menedżer połączeń HTTP określa ustawienia serwera proxy, takie jak adres URL serwera, poświadczenia dostępu do serwera usług sieciowych i czas oczekiwania. Aby uzyskać więcej informacji, zobacz Menedżer połączeń HTTP.

Ważne

Menedżer połączeń HTTP obsługuje tylko uwierzytelnianie anonimowe i uwierzytelnianie podstawowe. Nie obsługuje uwierzytelniania systemu Windows.

Menedżer połączeń HTTP może wskazywać witrynę sieci Web lub plik WSDL (Web Service Description Language). Adres URL menedżera połączeń HTTP, który wskazuje plik WSDL, zawiera ?WSDL parametr: na przykład https://MyServer/MyWebService/MyPage.asmx?WSDL.

Plik WSDL musi być dostępny lokalnie, aby skonfigurować zadanie usługi sieci Web przy użyciu okna dialogowego Edytor zadań usługi sieci Web udostępnianego przez projektanta usług SSIS.

  • Jeśli menedżer połączeń HTTP wskazuje witrynę sieci Web, plik WSDL musi zostać skopiowany ręcznie na komputer lokalny.

  • Jeśli menedżer połączeń HTTP wskazuje plik WSDL, można pobrać plik z witryny sieci Web do pliku lokalnego przez zadanie usługi sieci Web.

Plik WSDL zawiera listę metod, które oferuje usługa sieci Web, parametry wejściowe wymagane przez metody, odpowiedzi zwracane przez metody i sposób komunikowania się z usługą sieci Web.

Jeśli metoda używa parametrów wejściowych, zadanie usługi sieci Web wymaga wartości parametrów. Na przykład metoda usługi sieci Web, która zaleca długość nart, które należy kupić na podstawie wysokości, wymaga przesłania wysokości w parametrze wejściowym. Wartości parametrów można podać za pomocą ciągów zdefiniowanych w zadaniu lub zmiennych zdefiniowanych w zakresie zadania lub kontenera nadrzędnego. Zaletą używania zmiennych jest możliwość dynamicznego aktualizowania wartości parametrów przy użyciu konfiguracji pakietów lub skryptów. Aby uzyskać więcej informacji, zobacz Zmienne usług Integration Services (SSIS) i konfiguracje pakietów.

Wiele metod usługi sieci Web nie używa parametrów wejściowych. Na przykład metoda usługi sieci Web, która pobiera nazwy prezydentów, którzy urodzili się w bieżącym miesiącu, nie wymaga parametru wejściowego, ponieważ usługa sieci Web może określić bieżący miesiąc lokalnie.

Wyniki metody usługi sieci Web można zapisać w zmiennej lub w pliku. Menedżer połączeń plików służy do określenia pliku lub podania nazwy zmiennej w celu zapisania wyników. Aby uzyskać więcej informacji, zobacz File Connection Manager oraz Integration Services (SSIS) Variables.

Specyficzne wiadomości logowania dostępne w zadaniu usługi webowej

Poniższa tabela wymienia niestandardowe wpisy dziennika, które można włączyć w zadaniu usługi sieciowej. Więcej informacji znajdziesz w Integration Services (SSIS) Logging.

Wpis dziennika Description
WSTaskBegin Zadanie rozpoczęto od uzyskania dostępu do usługi sieci Web.
WSTaskEnd Zadanie zakończyło metodę usługi sieci Web.
WSTaskInfo Opisowe informacje o zadaniu.

Konfiguracja zadania usługi sieci Web

Właściwości można ustawić za pomocą projektanta usług SSIS lub programowo.

Aby uzyskać więcej informacji o właściwościach, które można ustawić w projektancie usług SSIS, kliknij następujący temat:

Aby uzyskać więcej informacji na temat ustawiania tych właściwości w projektancie usług SSIS, kliknij następujący temat:

Programowa konfiguracja zadania usługi sieci Web

Aby uzyskać więcej informacji na temat programowego ustawiania tych właściwości, kliknij jeden z następujących tematów:

Edytor zadań usługi internetowej (strona ogólna)

Użyj strony Ogólne okna dialogowego Edytora zadań usług sieci Web , aby określić menedżera połączeń HTTP, określić lokalizację pliku WSDL (Web Services Description Language) używanego przez zadanie usługi sieci Web, opisać zadanie usługi sieci Web i pobrać plik WSDL.

Opcje

HttpConnection
Wybierz menedżera połączeń na liście lub kliknij pozycję <Nowe połączenie...> w celu utworzenia nowego menedżera połączeń.

Ważne

Menedżer połączeń HTTP obsługuje tylko uwierzytelnianie anonimowe i uwierzytelnianie podstawowe. Nie obsługuje uwierzytelniania systemu Windows.

Tematy pokrewne:Menedżer połączeń HTTP, Edytor Menedżera połączeń HTTP (strona serwera)

WSDLFile
Wpisz w pełni kwalifikowaną ścieżkę pliku WSDL lokalnego na komputerze lub kliknij przycisk przeglądania (...) i znajdź ten plik.

Jeśli plik WSDL został już pobrany ręcznie na komputer, wybierz ten plik. Jeśli jednak plik WSDL nie został jeszcze pobrany, wykonaj następujące kroki:

  • Utwórz pusty plik z rozszerzeniem nazwy pliku ".wsdl".

  • Wybierz ten pusty plik dla opcji WSDLFile .

  • Ustaw wartość OverwriteWSDLFile na true , aby umożliwić zastąpienie pustego pliku rzeczywistym plikiem WSDL.

  • Kliknij pozycję Pobierz plik WSDL , aby pobrać rzeczywisty plik WSDL i zastąpić pusty plik.

    Uwaga / Notatka

    Opcja Pobierz plik WSDL nie jest włączona do momentu podania nazwy istniejącego pliku lokalnego w polu WSDLFile .

ZastąpWSDLFile
Określ, czy można nadpisać plik WSDL dla zadania Web Service.

Jeśli zamierzasz pobrać plik WSDL przy użyciu przycisku Pobierz plik WSDL , ustaw tę wartość na True.

Nazwa
Podaj unikatową nazwę zadania usługi sieci Web. Ta nazwa jest używana jako etykieta w ikonie zadania.

Uwaga / Notatka

Nazwy zadań muszą być unikatowe w pakiecie.

Opis
Wpisz opis zadania usługi sieciowej.

Pobierz plik WSDL
Pobierz plik WSDL.

Ten przycisk nie jest włączony do momentu podania nazwy istniejącego pliku lokalnego w polu WSDLFile .

Edytor zadań usługi internetowej (strona wejściowa)

Użyj strony Dane wejściowe okna dialogowego Edytora zadań usługi sieci Web , aby określić usługę sieci Web, metodę sieci Web i wartości, które mają być podane w metodzie sieci Web jako dane wejściowe. Wartości można podać, wpisując ciągi bezpośrednio w kolumnie Wartość lub wybierając zmienne w kolumnie Wartość.

Opcje

Usługa
Wybierz usługę sieci Web z listy, która ma zostać użyta do wykonania metody sieci Web.

Metoda
Wybierz metodę sieci Web z listy, aby wykonać zadanie.

WebMethodDocumentation
Wpisz opis metody sieci Web lub kliknij przycisk przeglądania (...), a następnie wpisz opis w oknie dialogowym Dokumentacja metody sieci Web.

Nazwa
Wyświetla nazwy danych wejściowych metody sieci Web.

Typ
Wyświetla typ danych wejściowych.

Uwaga / Notatka

Zadanie usługi sieci Web obsługuje tylko parametry następujących typów danych: typy pierwotne, takie jak liczby całkowite i ciągi; tablice i sekwencje typów pierwotnych; i wyliczenia.

Zmienna
Zaznacz pola wyboru, aby użyć zmiennych w celu podania danych wejściowych.

Wartość
Jeśli zaznaczono pola wyboru Zmienna, zaznacz zmienne na liście, aby podać dane wejściowe; w przeciwnym razie wpisz wartości do użycia w danych wejściowych.

Edytor zadań usługi internetowej (strona wyjściowa)

Użyj strony Dane wyjściowe okna dialogowego Edytora zadań usługi sieci Web , aby określić, gdzie ma być przechowywany wynik zwracany przez metodę sieci Web.

Opcje statyczne

Outputtype
Wybierz typ magazynu, który ma być używany podczas przechowywania wyników. Ta właściwość zawiera opcje wymienione w poniższej tabeli.

Wartość Description
połączenia plików Zapisz wyniki w pliku. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznej , Plik.
Zmienna Zapisz wyniki w zmiennej. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznej Zmiennej.

Opcje dynamiczne typu wyjściowego

OutputType = połączenie z plikiem

Plik
Wybierz menedżera połączeń plików z listy lub kliknij pozycję <Nowe połączenie...> w celu utworzenia nowego menedżera połączeń.

Tematy pokrewne: menedżer połączeń plików, edytor menedżera połączeń plików

OutputType = zmienna

Zmienna
Wybierz zmienną na liście lub kliknij pozycję <Nowa zmienna...> w celu utworzenia nowej zmiennej.

Tematy powiązane:Integration Services (SSIS) zmienne, Dodaj zmienną

Powiązana zawartość

Wideo, Instrukcje: wywoływanie usługi sieci Web przy użyciu zadania usługi sieci Web (wideo programu SQL Server) w technet.microsoft.com.

  • Last updated on