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

Dotyczy: Azure Logic Apps (Consumption + Standard)

Aby zautomatyzować zadania współpracujące z bazą danych usługi Microsoft Dataverse, możesz użyć łącznika Microsoft Dataverse z przepływami pracy w usłudze Azure Logic Apps.

Można na przykład tworzyć przepływy pracy, które tworzą wiersze, aktualizują wiersze i wykonują 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.

Łącznik Usługi Dataverse był wcześniej znany jako łącznik usługi Common Data Service 2.0 i pierwotnie znany jako łącznik usługi Dynamics 365. Łącznik Dataverse umożliwia dostęp do Microsoft Dataverse dla Microsoft Dynamics 365 Sales, Microsoft Dynamics 365 Customer Service, Microsoft Dynamics 365 Field Service, Microsoft Dynamics 365 Customer Insights — Journeys oraz Microsoft Dynamics 365 Project Service Automation.

W tym przewodniku pokazano, jak dodać wyzwalacz lub akcję usługi Dataverse do przepływu pracy oraz jak działają opcje parametrów.

Ważne

Od października 2023 r. nowe przepływy pracy muszą używać bieżących operacji łącznika Dataverse. Starsze operacje konektora Dataverse nie są już dostępne do użycia w nowych przepływach pracy.

Aby zapewnić zgodność z poprzednimi wersjami, starsze operacje łącznika usługi Dataverse miały rok od momentu ogłoszenia ich wycofania na kontynuowanie pracy w istniejących przepływach pracy. Mimo że nie istnieje określona data zamknięcia, upewnij się, że możesz szybko zaktualizować istniejące przepływy pracy, aby używać bieżących operacji łącznika. 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.

Referencja łącznika

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. Uzyskaj bezpłatne konto platformy Azure.

• Środowisko usługi Dataverse Data Service i baza danych, w którym organizacja przechowuje, zarządza i udostępnia dane biznesowe w bazie danych Dataverse.

  Aby uzyskać więcej informacji, zobacz:

  • Dowiedz się: Tworzenie środowisk Dataverse i zarządzanie nimi
  • Power Platform - przegląd środowisk

  Uwaga / Notatka

  Niektóre scenariusze mogą wymagać włączenia ograniczeń dostępu do zasobu aplikacji logiki w celu kontrolowania dostępu przychodzącego z sieci publicznych. Jeśli zezwalasz na komunikację przychodzącą z Power Platform, aby uruchomić przepływ pracy przy użyciu tagu usługi PowerPlatformInfra, upewnij się, że używasz wersji niezwiązanej z regionem.

• Podstawowa wiedza na temat usługi Azure Logic Apps, w tym zasoby aplikacji Logic Apps typu Consumption lub Standard oraz przepływ pracy, z którego chcesz uzyskać dostęp do bazy danych Dataverse. Aby użyć wyzwalacza Usługi Dataverse, potrzebny jest pusty przepływ pracy. Aby użyć akcji Usługi Dataverse, potrzebny jest przepływ pracy rozpoczynający się od dowolnego wyzwalacza odpowiedniego dla danego scenariusza.

  Aby uzyskać więcej informacji, zobacz:

  • Utwórz przykładowy przepływ pracy aplikacji Logic Apps typu Consumption
  • Stwórz przykładowy przepływ pracy standardowej aplikacji logicznej

Dodawanie wyzwalacza Dataverse

W zależności od tego, czy masz przepływ pracy aplikacji logiki typu Zużycie, czy Standardowa, wykonaj odpowiednie kroki:

1. W portalu Azure otwórz przepływ pracy aplikacji logicznej w edytorze.

2. Postępuj zgodnie z ogólnymi krokami , aby dodać odpowiedni wyzwalacz usługi Microsoft Dataverse dla danego scenariusza.

   W tym przykładzie jest kontynuowany wyzwalacz o nazwie Po dodaniu, zmodyfikowaniu lub usunięciu wiersza.

3. Po wyświetleniu monitu zaloguj się do środowiska Dataverse lub jego bazy danych.

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

   W poniższym przykładzie pokazano przykładowy wyzwalacz:

   

5. Gdy wszystko będzie gotowe, zapisz przepływ pracy. 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

1. W portalu Azure otwórz przepływ pracy aplikacji logicznej w edytorze.

2. Wykonaj ogólne kroki , aby dodać odpowiednią akcję microsoft Dataverse dla danego scenariusza.

   W tym przykładzie jest kontynuowana akcja o nazwie Dodaj nowy wiersz.

3. Po wyświetleniu monitu zaloguj się do środowiska Dataverse lub jego bazy danych.

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

   W poniższym przykładzie pokazano przykładową akcję:

   

5. Gdy wszystko będzie gotowe, zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

6. Dodaj więcej akcji, jeśli chcesz.

Testowanie przepływu pracy

Aby uruchomić przepływ pracy, wykonaj następujące kroki:

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

2. Odtwórz warunki, których wyzwalacz wymaga, aby uruchomić przepływ pracy.

Zwracanie wierszy na podstawie filtru

W przypadku akcji zwracanych wierszy, takich jak akcja Wyświetl wiersze , użyj zapytania ODATA, aby zwrócić wiersze na podstawie określonego filtru. Na przykład skonfiguruj akcję tak, aby zwracała tylko wiersze dla aktywnych kont.

1. W projektancie w akcji otwórz listę Zaawansowane parametry i wybierz parametr Filtruj wiersze .

   

2. W parametrze Filtruj wiersze , który jest teraz wyświetlany w akcji, wprowadź wyrażenie zapytania ODATA, na przykład:

   statuscode eq 1

   

Więcej informacji można znaleźć w następującej dokumentacji:

• Lista wierszy
• $filter opcje zapytania systemowego

Zwracanie wierszy na podstawie kolejności sortowania

W przypadku akcji, które zwracają wiersze, takie jak akcja Wyświetlanie wierszy , użyj zapytania ODATA, aby zwrócić wiersze w określonej sekwencji. Sekwencja różni się w zależności od wierszy zwracanych przez akcję. Na przykład możesz skonfigurować akcję tak, aby zwracała wiersze zorganizowane według nazwy konta.

1. W projektancie w akcji otwórz listę Zaawansowane parametry i wybierz parametr Sortuj według .

   

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

   

Więcej informacji można znaleźć w następującej dokumentacji:

• Lista wierszy
• $orderby opcje zapytania systemowego

Typy danych pól

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

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.

(No changes needed)	Typ danych	Description
Pole tekstowe	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 ukończenia - 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: - Utworzono w dniu - Data rozpoczęcia - Rozpoczęcie rzeczywiste - Rzeczywisty koniec - Termin
Pole odwołujące się do innego wiersza jednostki	Klucz podstawowy	Wymaga zarówno identyfikatora wiersza, takiego jak identyfikator GUID, jak i typu wyszukiwania, 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 wyszukiwania, 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 typ accounts lub contacts, odpowiednio. - Klient: musi być prawidłowym identyfikatorem wiersza, takim jak identyfikator konta lub identyfikator wiersza kontaktu. - Typ klienta: powinien 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, oraz właściwości Typ właściciela, która określa systemusers typ odwołania, operacja 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.

Wynikowa akcja wygląda podobnie do następującego przykładu:

Rozwiązywanie problemów

Wywołania z wielu środowisk

Łącznik usługi Dataverse przechowuje informacje o przepływach pracy aplikacji Logic Apps, które otrzymują i wymagają powiadomień o zmianach encji bazodanowych przy użyciu callbackregistrations encji w bazie danych Dataverse. Jeśli skopiujesz organizację usługi Dataverse, wszystkie elementy webhook zostaną automatycznie skopiowane. Jeśli skopiujesz swoją organizację, zanim wyłączysz przepływy pracy przypisane do organizacji, wszystkie skopiowane webhooki będą wskazywać na te same przepływy pracy aplikacji logiki. Następnie te przepływy pracy 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 w Dataverse, z której chcesz usunąć powiadomienia.

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

   1. Przejrzyj listę ogólną wszystkich rejestracji wywołań zwrotnych pod następującym identyfikatorem URI OData, aby wyświetlić dane w jednostce callbackregistrations.

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

      Uwaga / Notatka

      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 logiczną nazwę jednostki wyzwalającej entityname oraz zdarzenie powiadomienia zgodne z przepływem pracy aplikacji logicznej (komunikat). Każdy typ zdarzenia jest mapowany na liczbę całkowitą komunikatu w następujący sposób:

      Typ zdarzenia	Liczba całkowita komunikatu
      Create	1
      Usuń	2
      Update	3
      UtwórzLubZaktualizuj	4
      UtwórzLubUsuń	5
      AktualizujLubUsuń	6
      UtwórzLubZaktualizujLubUsuń	7

      W poniższym przykładzie pokazano, jak filtrować powiadomienia dla encji Create o nazwie nov_validation za pomocą poniższego 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 / Notatka

      Jeśli istnieje wiele wyzwalaczy dla tej samej jednostki lub zdarzenia, możesz filtrować listę, używając dodatkowych filtrów, takich jak atrybuty createdon oraz _owninguser_value. Pod /api/data/v9.0/systemusers({id}) wyświetla się nazwa użytkownika właściciela.

   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 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 standardowych przepływach pracy, w określonych warunkach, takich jak realokacja wystąpienia lub ponowne uruchomienie aplikacji, wyzwalacz Microsoft Dataverse powoduje uruchomienie duplikatu. Ta operacja duplikowania tworzy zduplikowaną callbackregistrations jednostkę w bazie danych Dataverse. Jeśli edytujesz standardowy przepływ pracy rozpoczynający się od wyzwalacza Dataverse, sprawdź, czy callbackregistrations jednostka jest zduplikowana. Jeśli duplikat istnieje, usuń ręcznie zduplikowaną callbackregistrations jednostkę.

Treści powiązane

• Łą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