Nawiązywanie połączenia z usługą Microsoft Dataverse z przepływów pracy w usłudze Azure Logic Apps

Dotyczy: Azure Logic Apps (Zużycie + Standardowa)

Ważne

30 sierpnia 2022 r. operacje łącznika dla usługi Common Data Service 2.0, znanej również jako Microsoft Dataverse (starsza wersja), przeprowadzono migrację do bieżącego łącznika usługi Microsoft Dataverse. Starsze operacje mają etykietę "starsza wersja", a bieżące operacje mają etykietę "wersja zapoznawcza". Możesz użyć bieżącego łącznika Usługi Dataverse w dowolnych istniejących lub nowych przepływach pracy aplikacji logiki. W celu zapewnienia zgodności z poprzednimi wersjami istniejące przepływy pracy nadal współpracują ze starszym łącznikiem usługi Dataverse. Pamiętaj jednak, aby przejrzeć te przepływy pracy i szybko je zaktualizować.

Od października 2023 r. starsza wersja stała się niedostępna dla nowych przepływów pracy. Istniejące przepływy pracy nadal działają, ale musisz używać bieżących operacji łącznika Dataverse dla nowych przepływów pracy. Zostanie ogłoszona oś czasu zamknięcia starszych akcji i wyzwalaczy. Aby uzyskać więcej informacji, zobacz Łącznik Usługi Microsoft Dataverse (starsza wersja) dla usługi Azure Logic Apps zostanie wycofany i zastąpiony innym łącznikiem.

Aby utworzyć i uruchomić zautomatyzowane przepływy pracy, które tworzą wiersze w bazie danych microsoft Dataverse i zarządzają nimi, możesz użyć usługi Azure Logic Apps i łącznika Microsoft Dataverse. Te przepływy pracy mogą tworzyć wiersze, aktualizować je i wykonywać inne operacje. Możesz również uzyskać informacje z bazy danych Dataverse i udostępnić dane wyjściowe innym akcjom używanym w przepływach pracy. Na przykład po dodaniu, zaktualizowaniu lub usunięciu wiersza w bazie danych Dataverse możesz wysłać wiadomość e-mail przy użyciu łącznika usługi Office 365 Outlook.

W tym przewodniku pokazano, jak utworzyć przepływ pracy, który tworzy wiersz zadania za każdym razem, gdy zostanie utworzony nowy wiersz potencjalnego klienta.

Informacje o łącznikach

Aby uzyskać informacje techniczne na podstawie opisu struktury Swagger łącznika, takich jak operacje, limity i inne szczegóły, zobacz stronę referencyjną łącznika zarządzanego.

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.

• Środowisko usługi Dataverse Data Service i baza danych, czyli miejsce, w którym organizacja przechowuje, zarządza i udostępnia dane biznesowe w bazie danych Dataverse. Aby uzyskać więcej informacji, zobacz następujące zasoby:

  • Dowiedz się: Tworzenie środowisk Dataverse i zarządzanie nimi

  • Power Platform - przegląd środowisk

• Podstawowa wiedza na temat tworzenia przepływów pracy aplikacji logiki Zużycie lub Standardowa oraz aplikacji logiki, z której chcesz uzyskać dostęp do wierszy w bazie danych Dataverse. Aby użyć wyzwalacza Usługi Dataverse, musisz zacząć od pustego przepływu pracy. Aby uzyskać więcej informacji, zobacz następujące zasoby:

  • Tworzenie przykładowego przepływu pracy aplikacji logiki Zużycie

  • Tworzenie przykładowego przepływu pracy aplikacji logiki w warstwie Standardowa

Dodawanie wyzwalacza Dataverse

Po dodaniu wyzwalacza lub akcji łączącej się z usługą lub systemem i nie masz istniejącego lub aktywnego połączenia, usługa Azure Logic Apps wyświetla monit o podanie informacji o połączeniu, które różnią się w zależności od typu połączenia, na przykład:

• Poświadczenia konta
• Nazwa do użycia dla połączenia
• Nazwa serwera lub systemu
• Typ uwierzytelniania do użycia
• Parametry połączenia

W tym przykładzie użyto wyzwalacza Dataverse, który uruchamia przepływ pracy po dodaniu, zaktualizowaniu lub usunięciu wiersza.

Uwaga

Łącznik Usługi Dataverse ma parametry specyficzne dla operacji i parametry specyficzne dla bazy danych. Na przykład po wybraniu tabeli parametry dostępne dla tej tabeli różnią się i różnią się od innych tabel.

Standardowa

1. W witrynie Azure Portal otwórz zasób standardowej aplikacji logiki i pusty przepływ pracy w projektancie.

2. W projektancie wykonaj następujące ogólne kroki, aby dodać wyzwalacz Microsoft Dataverse o nazwie Po dodaniu, zmodyfikowaniu lub usunięciu wiersza.

3. Jeśli zostanie wyświetlony monit, zaloguj się do środowiska lub bazy danych Usługi Dataverse.

4. W polu informacji o wyzwalaczu podaj niezbędne wartości.

   Aby zapoznać się z przykładowym wyzwalaczem, zobacz Po dodaniu, zmodyfikowaniu lub usunięciu wiersza.

   

5. Po zakończeniu zapisz przepływ pracy aplikacji logiki. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

6. Teraz dodaj co najmniej jedną akcję przepływu pracy do wykonania po uruchomieniu wyzwalacza. Możesz na przykład dodać akcję Dataverse lub akcję, która wysyła wiadomość e-mail na podstawie danych wyjściowych z wyzwalacza.

Zużycie

1. W witrynie Azure Portal otwórz zasób aplikacji logiki Zużycie i pusty przepływ pracy w projektancie.

2. W projektancie wykonaj następujące ogólne kroki, aby dodać wyzwalacz Microsoft Dataverse o nazwie Po dodaniu, zmodyfikowaniu lub usunięciu wiersza.

3. Jeśli zostanie wyświetlony monit, zaloguj się do środowiska lub bazy danych Usługi Dataverse.

4. W polu informacji o wyzwalaczu podaj niezbędne wartości.

   Aby zapoznać się z przykładowym wyzwalaczem, zobacz Po dodaniu, zmodyfikowaniu lub usunięciu wiersza.

   

5. Po zakończeniu zapisz przepływ pracy aplikacji logiki. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

6. Teraz dodaj co najmniej jedną akcję przepływu pracy do wykonania po uruchomieniu wyzwalacza. Możesz na przykład dodać akcję Dataverse lub akcję, która wysyła wiadomość e-mail na podstawie danych wyjściowych z wyzwalacza.

Dodawanie akcji Dataverse

Po dodaniu wyzwalacza lub akcji łączącej się z usługą lub systemem i nie masz istniejącego lub aktywnego połączenia, usługa Azure Logic Apps wyświetla monit o podanie informacji o połączeniu, które różnią się w zależności od typu połączenia, na przykład:

• Poświadczenia konta
• Nazwa do użycia dla połączenia
• Nazwa serwera lub systemu
• Typ uwierzytelniania do użycia
• Parametry połączenia

W tym przykładzie użyto akcji Dataverse, która dodaje nowy wiersz do bazy danych.

Uwaga

Łącznik Usługi Dataverse ma parametry specyficzne dla operacji i parametry specyficzne dla bazy danych. Na przykład po wybraniu tabeli parametry dostępne dla tej tabeli różnią się i różnią się od innych tabel.

Standardowa

1. W witrynie Azure Portal otwórz zasób aplikacji logiki w warstwie Standardowa i przepływ pracy w projektancie.

2. W projektancie wykonaj następujące ogólne kroki, aby dodać akcję Microsoft Dataverse o nazwie Dodaj nowy wiersz.

3. Jeśli zostanie wyświetlony monit, zaloguj się do środowiska lub bazy danych Usługi Dataverse.

4. W polu informacji o akcji podaj niezbędne wartości.

   Aby zapoznać się z przykładową akcją, zobacz Dodawanie nowego wiersza.

   

5. Po zakończeniu zapisz przepływ pracy aplikacji logiki. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

6. Kontynuuj dodawanie kolejnych akcji, jeśli chcesz.

Zużycie

1. W witrynie Azure Portal otwórz zasób aplikacji logiki Zużycie i przepływ pracy w projektancie.

2. W projektancie wykonaj następujące ogólne kroki, aby dodać akcję Microsoft Dataverse o nazwie Dodaj nowy wiersz.

3. Jeśli zostanie wyświetlony monit, zaloguj się do środowiska lub bazy danych Usługi Dataverse.

4. W polu informacji o akcji podaj niezbędne wartości.

   Aby zapoznać się z przykładową akcją, zobacz Dodawanie nowego wiersza.

   

5. Po zakończeniu zapisz przepływ pracy aplikacji logiki. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

6. Kontynuuj dodawanie kolejnych akcji, jeśli chcesz.

Testowanie przepływu pracy

Aby przetestować i wyzwolić przepływ pracy, wykonaj następujące kroki:

Standardowa

1. W menu przepływu pracy wybierz pozycję Przegląd.

2. Na pasku narzędzi Przegląd wybierz pozycję Uruchom>.

3. Odtwórz warunki, których wyzwalacz wymaga uruchomienia przepływu pracy.

Zużycie

1. Na pasku narzędzi projektanta wybierz pozycję Uruchom wyzwalacz>Uruchom.

2. Odtwórz warunki, których wyzwalacz wymaga uruchomienia przepływu pracy.

Zwracanie wierszy na podstawie filtru

W przypadku akcji zwracanych wierszy, takich jak akcja Wyświetl wiersze , można użyć zapytania ODATA zwracającego wiersze na podstawie określonego filtru. Możesz na przykład skonfigurować akcję tak, aby zwracała tylko wiersze dla aktywnych kont. Aby uzyskać więcej informacji na temat przykładowej akcji, zobacz Wyświetlanie listy wierszy.

Standardowa

1. W projektancie w akcji otwórz listę Zaawansowane parametry i wybierz właściwość Filtruj wiersze .

   

2. W właściwości Filtruj wiersze , która jest teraz wyświetlana w akcji, wprowadź wyrażenie zapytania ODATA, na przykład:

   statuscode eq 1

   

Aby uzyskać więcej informacji na temat $filter opcji zapytania systemowego, zobacz Wykonywanie zapytań dotyczących danych przy użyciu internetowego interfejsu API — filtrowanie wyników.

Zużycie

1. W projektancie w akcji otwórz listę Dodaj nowy parametr i wybierz właściwość Filtruj wiersze .

   

2. W właściwości Filtruj wiersze , która jest teraz wyświetlana w akcji, wprowadź wyrażenie zapytania ODATA, na przykład:

   statuscode eq 1

   

Aby uzyskać więcej informacji na temat $filter opcji zapytania systemowego, zobacz Wykonywanie zapytań dotyczących danych przy użyciu internetowego interfejsu API — filtrowanie wyników.

Zwracanie wierszy na podstawie kolejności sortowania

W przypadku akcji zwracanych wierszy, takich jak akcja Wyświetlanie wierszy , można użyć zapytania ODATA zwracającego wiersze w określonej sekwencji, które różni się w zależności od wierszy zwracanych przez akcję. Na przykład możesz skonfigurować akcję w celu zwrócenia wierszy zorganizowanych według nazwy konta. Aby uzyskać więcej informacji na temat przykładowej akcji, zobacz Wyświetlanie listy wierszy.

Standardowa

1. W projektancie w akcji otwórz listę Zaawansowane parametry i wybierz właściwość Sortuj według .

   

2. W właściwości Sortuj według , która jest teraz wyświetlana w akcji, wprowadź nazwę kolumny, która ma być używana do sortowania, na przykład nazwa:

   

Aby uzyskać więcej informacji na temat $orderby opcji zapytania systemowego, zobacz Wykonywanie zapytań dotyczących danych przy użyciu internetowego interfejsu API — sortuj według.

Zużycie

1. W projektancie w akcji otwórz listę Dodaj nowy parametr i wybierz właściwość Sortuj według .

   

2. W właściwości Sortuj według , która jest teraz wyświetlana w akcji, wprowadź nazwę kolumny, która ma być używana do sortowania, na przykład nazwa:

   

Aby uzyskać więcej informacji na temat $orderby opcji zapytania systemowego, zobacz Wykonywanie zapytań dotyczących danych przy użyciu internetowego interfejsu API — sortuj według.

Typy danych pól

W wyzwalaczu lub akcji typ danych wartości pola musi być zgodny z wymaganym typem danych pola. To wymaganie ma zastosowanie w przypadku ręcznego wprowadzania wartości lub wybierania wartości z listy zawartości dynamicznej.

Uwaga

Łącznik Usługi Dataverse ma parametry specyficzne dla operacji i parametry specyficzne dla bazy danych. Na przykład po wybraniu tabeli parametry dostępne dla tej tabeli różnią się i różnią się od innych tabel.

Załóżmy na przykład, że masz tabelę o nazwie Tasks (Zadania). Ta tabela zawiera pola, które mają zastosowanie tylko do tej tabeli, podczas gdy inne tabele mają własne pola. W przykładowej tabeli Tasks (Zadania ) w poniższej tabeli opisano niektóre przykładowe typy pól i typy danych, których te pola wymagają dla ich wartości.

Pole	Typ danych	opis
Text field	Jeden wiersz tekstu	Wymaga pojedynczego wiersza tekstu lub zawartości dynamicznej zawierającej typ danych tekstowych, na przykład następujące właściwości: - Opis - Kategoria
Pole Liczba całkowita	Liczba całkowita	Wymaga liczby całkowitej lub zawartości dynamicznej, która ma typ danych całkowitych, na przykład następujące właściwości: - Procent wykonania - Czas trwania
Pole daty	Data i godzina	Wymaga daty w formacie MM/DD/RRRR lub zawartości dynamicznej zawierającej typ danych daty, na przykład następujące właściwości: - Data utworzenia - Data rozpoczęcia - Rozpoczęcie rzeczywiste - Rzeczywisty koniec - Data ukończenia
Pole odwołujące się do innego wiersza jednostki	Klucz podstawowy	Wymaga zarówno identyfikatora wiersza, jak identyfikator GUID, jak i typu odnośnika, co oznacza, że wartości z listy zawartości dynamicznej nie będą działać, na przykład następujące właściwości: - Właściciel: musi być prawidłowym identyfikatorem użytkownika lub identyfikatorem wiersza zespołu. - Typ właściciela: musi być typem odnośnika, takim jak systemusers lub teams, odpowiednio. - Dotyczy: musi być prawidłowym identyfikatorem wiersza, takim jak identyfikator konta lub identyfikator wiersza kontaktu. - Dotyczy typu: musi być typem odnośnika, takim jak accounts lub contacts, odpowiednio. - Klient: musi być prawidłowym identyfikatorem wiersza, takim jak identyfikator konta lub identyfikator wiersza kontaktu. - Typ klienta: musi być typem odnośnika, takim jak accounts lub contacts, odpowiednio.

W przykładowej tabeli Tasks (Zadania ) załóżmy, że używasz akcji Dodaj nowy wiersz , aby utworzyć nowy wiersz skojarzony z innymi wierszami jednostki, w szczególności wierszem użytkownika i wierszem konta. Dlatego w tej akcji należy określić identyfikatory i typy odnośników dla tych wierszy jednostki przy użyciu wartości, które pasują do oczekiwanych typów danych dla odpowiednich właściwości.

• Na podstawie właściwości Właściciel, która określa identyfikator użytkownika i właściwość Typ właściciela, która określa systemusers typ odnośnika, akcja kojarzy nowy wiersz z określonym użytkownikiem.

• Na podstawie właściwości Dotyczy, która określa identyfikator wiersza i właściwość Dotyczy typu, która określa accounts typ odnośnika, akcja kojarzy nowy wiersz z określonym kontem.

Standardowa

Zużycie

Rozwiązywanie problemów

Wywołania z wielu środowisk

Łącznik usługi Dataverse przechowuje informacje o przepływach pracy aplikacji logiki, które pobierają i wymagają powiadomień o zmianach jednostek bazy danych przy użyciu callbackregistrations jednostki w bazie danych Dataverse. Jeśli skopiujesz organizację usługi Dataverse, wszystkie elementy webhook również zostaną skopiowane. Jeśli skopiujesz organizację przed wyłączeniem przepływów pracy mapowanych do organizacji, wszystkie skopiowane elementy webhook również wskazują na te same przepływy pracy aplikacji logiki, które następnie otrzymują powiadomienia z wielu organizacji.

Aby zatrzymać niepożądane powiadomienia, usuń callbackregistrations jednostkę z organizacji, która wysyła te powiadomienia, wykonując następujące kroki:

1. Zidentyfikuj i zaloguj się do organizacji Usługi Dataverse, z której chcesz usunąć powiadomienia.

2. W przeglądarce Chrome znajdź rejestrację wywołania zwrotnego, którą chcesz usunąć.

   1. Przejrzyj ogólną listę wszystkich rejestracji wywołań zwrotnych przy użyciu następującego identyfikatora URI OData, aby wyświetlić dane wewnątrz callbackregistrations jednostki:

      https://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations:

      Uwaga

      Jeśli nie są zwracane żadne wartości, być może nie masz uprawnień do wyświetlania tego typu jednostki lub nie zalogowano się do odpowiedniej organizacji.

   2. Odfiltruj nazwę entityname logiczną jednostki wyzwalającej i zdarzenie powiadomienia zgodne z przepływem pracy aplikacji logiki (komunikat). Każdy typ zdarzenia jest mapowany na liczbę całkowitą komunikatu w następujący sposób:

      Typ zdarzenia	Liczba całkowita komunikatu
      Utworzenie	1
      Delete	2
      Zaktualizuj	3
      CreateOrUpdate	100
      CreateOrDelete	5
      UpdateOrDelete	6
      CreateOrUpdateOrDelete	7

      W poniższym przykładzie pokazano, jak filtrować powiadomienia dla Create jednostki o nazwie nov_validation przy użyciu następującego identyfikatora URI OData dla przykładowej organizacji:

      https://fabrikam-preprod.crm1.dynamics.com/api/data/v9.0/callbackregistrations?$filter=entityname eq 'nov_validation' and message eq 1

      

      Uwaga

      Jeśli istnieje wiele wyzwalaczy dla tej samej jednostki lub zdarzenia, możesz filtrować listę przy użyciu dodatkowych filtrów, takich jak createdon atrybuty i _owninguser_value . Nazwa użytkownika właściciela jest wyświetlana w obszarze /api/data/v9.0/systemusers({id}).

   3. Po znalezieniu identyfikatora rejestracji wywołania zwrotnego, którą chcesz usunąć, wykonaj następujące kroki:

      1. W przeglądarce Chrome otwórz przeglądarkę Chrome Developer Tools (Klawiatura: F12).

      2. W oknie u góry wybierz kartę Konsola.

      3. W wierszu polecenia wprowadź to polecenie, które wysyła żądanie usunięcia określonej rejestracji wywołania zwrotnego:

         fetch('http://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations({ID-to-delete})', { method: 'DELETE'})

         Ważne

         Upewnij się, że wysyłasz żądanie ze strony bez ujednoliconego interfejsu klienta (UCI), na przykład ze strony odpowiedzi OData lub interfejsu API. W przeciwnym razie logika w pliku app.js może zakłócać tę operację.

   4. Aby potwierdzić, że rejestracja wywołania zwrotnego już nie istnieje, sprawdź listę rejestracji wywołań zwrotnych.

Zduplikowana jednostka "callbackregistrations"

W przepływach pracy aplikacji logiki w warstwie Standardowa w określonych warunkach, takich jak ponowne uruchomienie wystąpienia lub ponowne uruchomienie aplikacji, wyzwalacz usługi Microsoft Dataverse uruchamia zduplikowaną jednostkę, która tworzy zduplikowaną callbackregistrations jednostkę w bazie danych Dataverse. Jeśli edytujesz standardowy przepływ pracy rozpoczynający się od wyzwalacza Usługi Dataverse, sprawdź, czy ta callbackregistrations jednostka jest zduplikowana. Jeśli duplikat istnieje, usuń ręcznie zduplikowaną callbackregistrations jednostkę.

Następne kroki

• Łączniki zarządzane dla usługi Azure Logic Apps
• Wbudowane łączniki dla usługi Azure Logic Apps
• Co to są łączniki w usłudze Azure Logic Apps