Użyj odwołania do połączenia w rozwiązaniu Microsoft Dataverse

Łącznik to obiekt pośredniczący lub otoka interfejsu API, który umożliwia usłudze źródłowej komunikację z usługami Microsoft Power Automate, Microsoft Power Apps i Azure Logic Apps. Oferuje użytkownikom metodę łączenia ich kont oraz korzystania z zalet zestawu wstępnie skompilowanych akcji i wyzwalaczy w celu tworzenia własnych aplikacji i przepływów pracy.

Połączenie jest przechowywanym poświadczeniem uwierzytelniania dla łącznika, na przykład poświadczeń OAuth dla łącznika SharePoint.

Odwołanie do połączenia to składnik rozwiązania, który zawiera odniesienie do połączenia dotyczącego określonego złącza. Obie aplikacje kanwy związane z rozwiązaniem i operacje w ramach przepływu związanego z rozwiązaniem, a nie bezpośrednio z połączeniem. Podczas importu rozwiązania do środowiska docelowego jest dostępne połączenie dla wszystkich odwołań do połączenia, dzięki czemu wszystkie przepływy odwołań mogą zostać automatycznie włączone po zakończeniu importowania. Aby zmienić konkretne połączenie skojarzone z aplikacją lub przepływem kanwy, należy edytować składnik odwołanie do połączenia w rozwiązaniu.

Dodaj odwołania do połączenia do rozwiązania

Odwołania do połączeń można dodawać do rozwiązania na różne sposoby:

  • Gdy używasz eksploratora rozwiązań do tworzenia nowego odwołania do połączenia w rozwiązaniu.

  • Podczas importowania rozwiązania. Aby dowiedzieć się więcej, przejdź do sekcji Importowanie rozwiązań.

  • Niejawnie podczas tworzenia aplikacji kanwy i przepływów, które są zdefiniowane w rozwiązaniu Microsoft Dataverse.

Uwaga

  • Aplikacje kanwy i przepływy obsługują połączenia w różny sposób. Przepływy używają referencji połączeń dla wszystkich złączy, podczas gdy aplikacje canvas używają ich tylko dla niejawnie współdzielonych (nie-OAuth) połączeń, takich jak SQL Server Authentication. Więcej informacji: Bezpieczeństwo i rodzaje uwierzytelniania
  • Informacje o połączeniu są tworzone automatycznie podczas tworzenia nowych połączeń między projektantami aplikacji przepływ i obszar roboczy.
  • Aplikacje i przepływy kanwy dodane z rozwiązań zewnętrznych nie zostaną automatycznie uaktualnione do korzystania z odwołań do połączeń.
  • Odwołania do połączeń są kojarzone z aplikacjami kanwy tylko w momencie dodawania źródła danych do aplikacji. Aby uaktualnić aplikacje, musisz usunąć połączenie z aplikacji, a następnie dodać połączenie zawierające powiązane odniesienie do połączenia.

Ręczne dodawanie odwołania do połączenia przy użyciu eksploratora rozwiązań

  1. Zaloguj się w Power Apps lub Power Automate.

  2. W lewym okienku wybierz Rozwiązania. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.

  3. Utwórz nowe lub otwórz istniejące rozwiązanie.

  4. Na pasku poleceń wybierz Nowe > Więcej > Odwołanie do połączenia.

  5. W okienku Odniesienie do nowego połączenia wprowadź następujące informacje. Kolumny wymagane są oznaczone gwiazdką (*).

    • Nazwa wyświetlana: Wprowadź unikatową i przydatną nazwę, aby rozróżniać to odwołanie do połączenia od innych.
    • Dodaj opis: wprowadź tekst opisujący połączenie.
    • Łącznik: wybierz istniejący łącznik z listy, na przykład ten na zrzucie ekranu. Możesz również wybrać Nowy, aby utworzyć nowe połączenie dla tego odnośnika. Po zakończeniu tworzenia nowego połączenia, wybierz Odśwież, aby wybrać połączenie z listy.
    • Połączenie: W zależności od wybranego Połączenia, wybierz istniejące połączenie lub wybierz Nowe połączenie, aby je utworzyć.
  6. Wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający panel Informacje o nowym połączeniu.

Nazywanie odwołania do połączenia

Nazwa wyświetlana odwołania do połączenia powinna być unikatowa, tak aby różne odwołania do połączenia można rozróżniać było odróżniać po nazwie. Domyślnie nazwa referencyjna połączenia zawiera docelowy łącznik, bieżącą nazwę rozwiązania dla kontekstu oraz losowy sufiks, aby zapewnić unikatowość. Rozważ dostosowanie nazwy odwołania do połączenia na coś unikatowego i coś, co będzie objaśniać, do czego będzie ono używane.

Ponowne wykorzystanie połączeń w przepływie rozwiązania

Przepływy utworzone poza rozwiązaniem korzystają bezpośrednio z połączeń. Przepływy utworzone w rozwiązaniu używają referencji połączeń i punktów referencyjnych połączeń. Aby ponownie wykorzystać połączenie w ramach przepływu rozwiązania, należy najpierw utworzyć referencję połączenia wskazującą na to połączenie.

Aktualizowanie przepływu w celu używania odwołań do połączenia zamiast połączeń

Jeśli przepływ nie znajduje się w rozwiązaniu, używa połączeń. Jeśli przepływ zostanie dodany do rozwiązania, będzie on nadal wstępnie używać połączeń. Przepływy można zaktualizować, aby użyć odwołań połączeń zamiast połączeń na jeden z dwóch sposobów:

  1. Jeśli przepływ jest eksportowany w rozwiązaniu niezarządzanym i importowany, połączenia zostaną usunięte i zastąpione odwołaniami do połączenia.

  2. Po otwarciu przepływu rozwiązania na stronie szczegółów przepływu na stronie szczegółów przepływu zostanie wyświetlane ostrzeżenie, aby użyć odwołań do połączenia. Komunikat ostrzegawczy zawiera akcję Usuń połączenia, aby można było dodawać odwołania do połączenia. Wybranie tej akcji spowoduje usunięcie połączeń z wyzwalacza i akcji w przepływie oraz umożliwi wybranie i utworzenie referencji połączeń.

Automatyczne użycie referencji połączeń w przepływie rozwiązania

Gdy akcja jest dodawana do przepływu rozwiązania, Power Automate spróbuje ponownie wykorzystać istniejące Referencje połączeń z bieżącego rozwiązania lub innych rozwiązań przed utworzeniem nowego Referencje połączeń. Aby upewnić się, że referencja połączenia znajduje się w tym samym rozwiązaniu co przepływ, utwórz lub dodaj referencję połączenia w tym samym rozwiązaniu i odwołaj się do niej z przepływu.

Udostępnianie połączeń innym użytkownikom w celu obsługi przepływów

Gdy przepływ jest włączony (aktywowany), użytkownik włączający przepływ musi posiadać lub mieć uprawnienia do użycia wszystkich połączeń w przepływie. Zwykle odbywa się to przez utworzenie przez właściciela przepływu połączeń wewnątrz wszystkich odwołań do połączenia, z których korzysta przepływ. Jeśli użytkownik inny niż właściciel przepływu zapewnia połączenia w przepływie, przepływ musi zostać włączony przez właściciela tych połączeń lub połączenia muszą zostać udostępnione użytkownikowi, który włącza przepływ.

Uwaga

Połączenia OAuth mogą być dostępne tylko w sposób jawny dla użytkownika reprezentującego nazwę główną usługi.

Ręczne udostępnianie połączeń w celu włączenia przepływu

Udostępnianie połączeń można wykonać, wykonać następujące kroki.

  1. Przejdź do Power Apps i wybierz środowisko zawierające połączenie.

  2. Wybierz Połączenie w lewym okienku nawigacji, a następnie wybierz połączenie do udostępnienia. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.

  3. Z menu wybierz Udostępnij.

  4. Na ekranie udostępniania wprowadź nazwę użytkownika (nazwy głównej usługi), który włączy przepływ.

  5. Dla uprawnień wybierz opcję Można użyć.

  6. Aby zakończyć udostępnianie, wybierz Zapisz.

Automatyczne udostępnianie połączeń w celu umożliwienia przepływu

Aby zautomatyzować udostępnianie połączeń, należy użyć akcji Edytowanie przypisania ról połączenia w łączniku Power Apps dla twórców.

Zrzut ekranu przedstawiający przykład udostępniania połączenia.

Limity

  • Odwołania do połączeń są teraz zapisywane asynchronicznie. W przeciwieństwie do okresu zapoznawczego nie ma już limitu liczby przepływów, które mogą odwoływać się do tego samego odwołania do połączenia. Gdy odwołania do połączeń są aktualizowane, pojawia się baner informacyjny, który łączy się z panelem zawierającym szczegóły aktualizacji asynchronicznej.
  • Nie istnieje także ograniczenie liczby akcji w każdym przepływie, które mogą być skojarzone z odwołaniem do połączenia.
  • Aplikacje kanwy nie rozpoznają odwołań do połączeń w niestandardowych łącznikach. Aby usunąć to ograniczenie, po zaimportowaniu rozwiązania do środowiska aplikacja musi być edytowana w celu usunięcia, a następnie odczytała połączenie łącznika niestandardowego. Uwaga: jeśli ta aplikacja znajduje się w rozwiązaniu zarządzanym, kontynuowanie edycji aplikacji spowoduje utworzenie warstwy niezarządzanej. Więcej informacji: Warstwy rozwiązań

Znane problemy

W tej sekcji opisano znane problemy dotyczące odwołań do połączeń.

Kopiowanie środowiska przerwie odwołania do połączeń łączników niestandardowych

Łączniki niestandardowe używają identyfikatora specyficznego dla środowiska w celu odwołania do łącznika niestandardowego. Po operacji kopiowania środowiska należy utworzyć nowe odwołanie do nowego łącznika niestandardowego. Wówczas wszelkie aplikacje lub przepływy korzystające ze starych odwołań do połączenia trzeba będzie naprawić.

Łączniki niestandardowe należy importować w innym rozwiązaniu niż ich odwołania do połączeń

Łączniki niestandardowe należy importować w innym rozwiązaniu niż ich odwołania do połączeń lub przepływy. W pierwszej kolejności należy wyeksportować rozwiązanie zawierające tylko łącznik niestandardowy.

Często zadawane pytania

Jak naprawić błąd "Nieprawidłowe połączenie"?

Jeśli odwołanie do połączenia jest wyświetlane jako "nieprawidłowe", gdzie na stronie szczegółów przepływu pojawia się czerwony punkt wykrzyknika, oznacza to, że podstawowe połączenie jest w nieprawidłowym stanie. W takim przypadku należy sprawdzić i naprawić podstawowe połączenie, aktualizując połączenie lub zastąp połączenie.

Co to jest błąd ConnectionAuthorizationFailed? Dlaczego nie można włączyć (aktywować) przepływu?

Błąd "ConnectionAuthorizationFailed" wskazuje, że użytkownik próbujący aktywować przepływ nie ma uprawnień do co najmniej jednego z połączeń korzystających z przepływu. Aby rozwiązać sytuację, wybierz jedno z następujących problemów:

  • Użytkownicy, którzy są właścicielami połączeń, muszą udostępniać wszystkie połączenia użytkownikowi, który włącza (aktywuje) przepływ.
  • Jeśli jeden użytkownik jest właścicielem wszystkich połączeń w przepływie, może włączyć (aktywować) przepływ.

Po włączeniu przepływu przez właściciela połączeń przepływ ma uprawnienia do korzystania z tych połączeń. Od tego momentu dowolny właściciel przepływu może włączyć przepływ.

Czy przepływ może zostać włączony przez właściciela jego połączeń, a następnie własność przeniesiona na innego użytkownika?

Tak. Gdy przepływ jest włączony (aktywowany) przez właściciela połączeń używanych przez przepływ, wówczas przepływ otrzymuje wyraźne pozwolenie na korzystanie z tych połączeń. Współwłaściciele przepływu mogą następnie wyłączać i włączać przepływ w zależności od potrzeb.

Uprawnienia przyznane aplikacjom i przepływom korzystającym z połączenia można zobaczyć na stronie szczegółów tego połączenia w zakładkach Aplikacje korzystające z tego połączenia i Przepływy korzystające z tego połączenia.

Jeśli przepływ jest edytowany w celu dodania nowych akcji, które używają dodatkowych odniesień do połączeń z nowymi połączeniami, wówczas właściciel tych nowych połączeń musi albo początkowo włączyć przepływ samodzielnie, albo udostępnić połączenia właścicielowi, który włącza przepływ. Aby uzyskać więcej informacji, zobacz Udostępnianie zasobów aplikacji

Czy własność odwołania do połączenia może być przeniesiona na innego użytkownika?

Własność odwołania do połączenia nie może być przeniesiona na innego użytkownika z obszaru Rozwiązania w Power Apps (make.powerapps.com).

Jednak klasyczny eksplorator rozwiązań umożliwia zmianę uprawnień do odwołania do połączenia, w tym udostępniania.

Zobacz też

Łączniki

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).