Tworzenie i rejestrowanie niestandardowych łączników SOAP w Azure Logic Apps (wersja zapoznawcza)

[Ten temat stanowi wstępną wersję dokumentacji i może ulec zmianie].

Aby zintegrować usługi SOAP z przepływami pracy Azure Logic Apps, możesz utworzyć i zarejestrować niestandardowy łącznik Simple Object Access Protocol (SOAP) za pomocą Web Services Description Language (WSDL), który opisuje twoją usługę SOAP. Łączniki SOAP działają tak, jak wbudowane łączniki, tak aby można było ich używać w taki sam sposób jak w przypadku innych łączników w aplikacjach logicznych. Obecnie niestandardowe łączniki SOAP nie obsługują operacji jednokierunkowych.

Ważne

  • Jest to funkcja w wersji zapoznawczej.

  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Wymagania wstępne

Do zarejestrowania łącznika SOAP są potrzebne:

  • Subskrypcja Azure. Jeśli nie masz subskrypcji, możesz skorzystać z bezpłatnego konta Azure. Alternatywnie możesz zapisać się na subskrypcję modelu kalkulacji wyceny zgodnie z rzeczywistym zużyciem (PAYG).

  • Dowolny z następujących elementów:

    • Adres URL do pliku WSDL definiujący usługę SOAP oraz wszystkie interfejsy API.
    • Plik WSDL definiujący usługę SOAP oraz wszystkie interfejsy API.

    W tej procedurze można skorzystać z przykładu Orders SOAP services (http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl).

  • (Opcjonalne) Obraz używany jako ikona łącznika niestandardowego.

1. Utwórz łącznik

  1. W portalu Azure Portal, w menu głównym Azure, wybierz Nowy.

  2. W polu wyszukiwania wpisz łącznik aplikacji logicznych, a następnie naciśnij Enter.

    Zrzut ekranu przedstawiający wyszukiwanie "łącznik Logic Apps".

  3. Z listy wyników wybierz pozycję Logic Apps Connector > Utwórz.

    Zrzut ekranu złącza tworzenie Logic Apps.

  4. Wprowadź szczegółowe informacje o rejestrowaniu łącznika opisano w tabeli. Po zakończeniu wybierz pole wyboru Przypnij do pulpitu nawigacyjnego, a następnie wybierz opcję Utwórz.

    Zrzut ekranu szczegółów łącznika niestandardowego Logic Apps.

    Właściwości Sugerowana wartość opis
    Nazwa/nazwisko soap-connector-name Wprowadź nazwę łącznika.
    Subskrypcja Azure-subscription-name Wybierz subskrypcję platformy Azure.
    Resource group Azure-resource-group-name Utwórz lub wybierz grupę Azure w celu zorganizowania zasobów Azure.
    Lokalizacja deployment-region Wybierz taki sam region Azure jak w aplikacji logicznej.

Po tym, jak Azure wdroży Twój łącznik, powinno się otworzyć menu łącznika aplikacji logicznej. Jeśli tak nie jest, wybierz swój łacznik SOAP z pulpitu Azure.

2. Zdefiniuj łącznik

Określ plik WSDL lub adres URL na potrzeby tworzenia łącznika, uwierzytelniania używanego przez łącznik oraz akcji i wyzwalaczy udostępnianych przez łącznik protokołu SOAP.

2a. Określ plik WSDL lub adres URL dla danego łącznika

  1. W menu łącznika, jeśli nie zostało jeszcze wybrane, wybierz łącznik Logic Apps.

  2. Wybierz Edytuj na pasku narzędzi.

    Zrzut ekranu edycji własnego łącznika

  3. Wybierz Ogólne, aby w tych tabelach podać szczegóły dotyczące tworzenia, zabezpieczania oraz definiowania akcji i wyzwalaczy dla Twojego łącznika SOAP.

    1. Dla Łączników niestandardowych wybierz SOAP jako Punkt końcowy API, aby dostarczyć plik WSDL opisujący twoje API.

      Zrzut ekranu przedstawiający udostępnienie pliku WSDL dla interfejsu API

      Opcja Formatuj opis
      Przekaż WSDL z pliku Plik WSDL Przejdź do lokalizacji pliku WSDL i wybierz odpowiedni plik.
      Przekaż WSDL z adresu URL http://path-to-wsdl-file Wprowadź adres URL dla pliku WSDL usługi.
      SOAP na format REST Nie dotyczy Przekształcenie interfejsów API w usłudze SOAP na interfejsy API REST.
    2. Aby uzyskać Ogólne informacje, przekaż ikonę łącznika.

      Zazwyczaj pola Opis, Host i Podstawowy adres URL są automatycznie wypełniane na podstawie pliku WSDL. Jeśli tak się nie stanie, dodaj te informacje w sposób opisany w tabeli i wybierz opcję Kontynuuj.

      Zrzut ekranu przedstawiający szczegóły łączników.

      Opcja lub ustawienie Formatuj opis
      Przekaż ikonę png-or-jpg-file-under-1-MB Ikona reprezentująca łącznik

      Kolor: najkorzystniej białe logo na kolorowym tle.

      Wymiary: logo o rozmiarze około 160 × 160 pikseli w kwadracie o rozmiarze 230 × 230 pikseli

      Kolor tła ikony icon-brand-color-hexadecimal-code Kolor za ikoną zgodny z kolorem tła w pliku ikony.

      Format: szesnastkowy. Na przykład, #007ee5 reprezentuje kolor niebieski.

      opis connector-description Wprowadź krótki opis łącznika.
      Gospodarz connector-host Wprowadź domenę hosta dla usługi SOAP.
      Podstawowy adres URL connector-base-URL Wprowadź podstawowy adres URL dla usługi SOAP.

2b. Opisz sposób uwierzytelniania używany przez łącznik

  1. Wybierz opcję Zabezpieczenia, aby przejrzeć lub opisać uwierzytelnianie używane przez łącznik. Uwierzytelnianie polega na upewnieniu się, że tożsamość użytkowników przekazywane są prawidłowo między daną usługą a wszystkimi klientami.

    Domyślnie Typ uwierzytelniania na tym łączniku jest ustawiony na Brak uwierzytelniania.

    Zrzut ekranu nowego typu uwierzytelnienia.

    Aby zmienić typ uwierzytelniania, wybierz opcję Edytuj. Użytkownik może wybrać Uwierzytelnianie podstawowe. Aby użyć etykiet parametrów innych niż wartości domyślne, należy zaktualizować je na Etykiecie parametru.

    Zrzut ekranu nowego typu uwierzytelnienia podstawowego.

  2. Aby zapisać swój łącznik po wprowadzeniu informacji o zabezpieczeniach, na górze strony wybierz Uaktualnij łącznik, a następnie wybierz Dalej.

2c. Przeglądanie, aktualizowanie i definiowanie akcji i wyzwalaczy dla łącznika

  1. Wybierz Definicje, aby przejrzeć, edytować lub zdefiniować nowe akcje i wyzwalacze, które użytkownicy mogą dodawać do swoich przepływów pracy.

    Akcje i wyzwalacze są oparte na operacjach zdefiniowanych w pliku WSDL, co powoduje automatyczne wypełnienie strony Definicja i uwzględnienie wartości żądań i odpowiedzi. Jeśli wymagane operacje już się tu pojawiły, możesz przejść do następnego kroku w procesie rejestracji bez dokonywania zmian na tej stronie.

    Zrzut ekranu z definicją łącznika.

  2. (Opcjonalnie) Jeśli chcesz edytować istniejące akcje i wyzwalacze lub dodać nowe, przejdź do przykładu edytowania definicji interfejsu API.

3. Zakończ tworzenie łącznika

Kiedy będziesz gotowy, wybierz Aktualizuj łącznik, aby go wdrożyć swój.

Gratulacje! Tworząc aplikację logiczną, można znaleźć łącznik w Projektancie usługi Logic Apps i dodać go do aplikacji logicznej.

Zrzut ekranu pokazujący, jak znaleźć swój łącznik w Logic Apps Designer

Udostępnij łącznik użytkownikom innych aplikacji Logic Apps

Zarejestrowane, ale niecertyfikowane łączniki niestandardowe działają jak łączniki fabryczne, z jednym wyjątkiem. Są one dostępne tylko dla autora i użytkowników łącznika, którzy mają taką samą dzierżawę tożsamości Microsoft Entra i subskrypcję platformy Azure dla aplikacji Logic Apps w regionie, w którym te aplikacje zostały wdrożone. Mimo że udostępnianie jest opcjonalne, mogą istnieć scenariusze, w których lepiej udostępniać łączniki innym użytkownikom.

Ważne

W przypadku udostępnienia łącznika inne osoby mogą zacząć od tego łącznika. Usunięcie łącznika powoduje usunięcie wszystkich połączeń z tym łącznikiem.

Aby udostępnić swój łącznik użytkownikom zewnętrznym poza tymi granicami — na przykład wszystkim użytkownikom Logic Apps — należy certyfikować swój łącznik. Aby dowiedzieć się więcej, przejdź na stronę Certyfikacja łącznika.

Często zadawane pytania

Pytanie: Czy łącznik SOAP jest ogólnie dostępny?
Odp.: Łącznik SOAP jest w wersji zapoznawczej i nie jest jeszcze usługą ogólnie dostępną.

Pytanie: Czy istnieją ograniczenia i znane problemy dotyczące łącznika protokołu SOAP?
Odpowiedź: Tak. Aby dowiedzieć się więcej, przejdź do strony Ograniczenia dotyczące złącza SOAP i znane problemy.

Pytanie: Czy istnieją jakieś ograniczenia dotyczące łączników niestandardowych?
Odpowiedź: Tak. Aby dowiedzieć się więcej, przejdź na stronę niestandardowe ograniczenia złączy.

Uzyskiwanie pomocy technicznej

  • Aby uzyskać pomoc w zakresie opracowywania i przyłączania lub żądania funkcji, które nie są dostępne w kreatorze rejestracji skontaktuj się z condevhelp@microsoft.com. Firma Microsoft monitoruje to konto w celu uzyskania pytań i problemów od deweloperów oraz rozsyła je do odpowiedniego zespołu.

  • Aby zadać lub odpowiedzieć na pytania, albo zobaczyć, co robią inni użytkownicy Logic Apps, przejdź na stronę forum Logic Apps Azure

  • Aby pomóc w ulepszaniu Logic Apps, głosuj lub zgłaszaj pomysły na stronie strona z opiniami użytkowników Logic Apps.

Zobacz też

Certyfikowanie swojego łącznika
Często zadawane pytania na temat łącznika niestandardowego w Azure Logic Apps, Power Automate i Power Apps

Przekazywanie opinii

Jesteśmy wdzięczni za opinie na temat problemów z platformą łączników oraz pomysły na nowe funkcje. Aby przekazać opinię, przejdź na stronę Przesyłanie problemów lub uzyskiwanie pomocy dotyczącej łączników i wybierz typ opinii.