Nawiązywanie połączenia z usługą Microsoft Dataverse

Uwaga

Obowiązuje od listopada 2020 r.:

  • Nazwa Common Data Service została zmieniona na Microsoft Dataverse. Dowiedz się więcej
  • Część terminologii w Microsoft Dataverse została zaktualizowana. Na przykład encja jest teraz tabelą, a pole jest teraz kolumną. Dowiedz się więcej

W tym temacie opisano sposób konfigurowania połączenia między Business Central i Dataverse. Zazwyczaj firmy tworzą połączenie w celu zintegrowania i zsynchronizowania danych z inną aplikacją biznesową Dynamics 365, taką jak Dynamics 365 Sales.

Zanim zaczniesz

Istnieje kilka informacji, które należy przygotować przed utworzeniem połączenia:

  • Adres URL środowiska Dataverse, z którym chcesz się połączyć. Jeśli użyjesz przewodnika konfiguracji wspomaganej konfiguracji połączenia Dataverse do utworzenia połączenia, odkryjemy Twoje środowiska, ale możesz również wprowadzić adres URL innego środowiska w dzierżawie.
  • Nazwa użytkownika i hasło konta, które ma uprawnienia administratora w Business Central i Dataverse.
  • Jeśli masz lokalny business central 2020 w wersji 1, wersja 16.5, przeczytaj artykuł Niektóre znane problemy. Przed utworzeniem połączenia z Dataverse musisz wykonać opisane obejście.
  • Waluta lokalna firmy w Business Central musi być taka sama jak waluta transakcji bazowej w Dataverse. Po ustawieniu transakcji podstawowej w Dataverse nie można jej zmienić. Aby uzyskać więcej informacji, zobacz Encja Waluta transakcji (waluta). Oznacza to, że wszystkie firmy Business Central, które łączysz z organizacją Dataverse, muszą używać tej samej waluty.
Ważny

Środowisko Dataverse nie może być w trybie administracyjnym. Tryb administracyjny spowoduje niepowodzenie połączenia, ponieważ konto użytkownika integracji dla połączenia nie ma uprawnień administratora. Aby uzyskać więcej informacji, zobacz Tryb administracyjny.

Uwaga

W tych krokach opisano procedurę dla Business Central online. Jeśli używasz Business Central lokalnie i nie używasz konta Azure Active Directory do łączenia się z Dataverse, musisz również określić nazwę użytkownika i hasło konta użytkownika na potrzeby integracji. To konto jest określane jako konto "użytkownika integracji". Jeśli używasz konta usługi Azure Active Directory, konto użytkownika integracji nie jest wymagane ani wyświetlane. Użytkownik integracji zostanie skonfigurowany automatycznie i nie wymaga licencji.

Konfigurowanie połączenia z Dataverse

W przypadku wszystkich typów uwierzytelniania innych niż uwierzytelnianie platformy Microsoft 365 skonfiguruj połączenie z Usługą Dataverse na stronie Konfiguracja połączenia Dataverse.For all types authentication other than Microsoft 365 authentication, you set up your connection to Dataverse on the Dataverse Connection Setup page. W przypadku uwierzytelniania platformy Microsoft 365 zalecamy skorzystanie z przewodnika konfiguracji wspomaganej konfiguracji połączenia Dataverse. Przewodnik ułatwia konfigurowanie połączenia i określanie funkcji zaawansowanych, takich jak model własności i synchronizacja początkowa.

Ważny

Podczas konfigurowania połączenia z Dataverse administrator zostanie poproszony o nadanie następujących uprawnień zarejestrowanej aplikacji platformy Azure o nazwie Business Central Integration to Dataverse:During the setup of the connection to Dataverse, the administrator will be asked to give following permissions to a registered Azure application named Business Central Integration to Dataverse:

  • Dostęp do Dataverse, ponieważ uprawnienia są potrzebne, aby Business Central mógł, w imieniu administratora, automatycznie tworzyć nieaukcyjnych nieakcyjnych użytkowników aplikacji Business Central Integration, przypisywać role zabezpieczeń do tego użytkownika i wdrażać Business Central Integration Solution w Dataverse. To uprawnienie jest używane tylko raz podczas konfigurowania połączenia z Dataverse.
  • Pełny dostęp do Dynamics 365 Business Central jest potrzebny, aby automatycznie utworzony użytkownik aplikacji Business Central Integration mógł uzyskać dostęp do danych Business Central, które będą synchronizowane.
  • Logowanie i odczytywanie uprawnień do profilu jest potrzebne do sprawdzenia, czy logowanie użytkownika faktycznie ma przypisaną rolę zabezpieczeń Administrator systemu w Dataverse.

Udzielając zgody w imieniu organizacji, administrator uprawnia zarejestrowaną aplikację platformy Azure o nazwie Business Central Integration do Dataverse do synchronizowania danych przy użyciu automatycznie utworzonych poświadczeń użytkownika aplikacji Business Central Integration.

Aby skorzystać z przewodnika konfiguracji wspomaganej konfiguracji połączenia Dataverse

Przewodnik konfiguracji połączenia Dataverse może ułatwić łączenie aplikacji, a nawet może pomóc w uruchomieniu początkowej synchronizacji. Jeśli zdecydujesz się uruchomić synchronizację początkową, Business Central przejrzy dane w obu aplikacjach i przedstawi zalecenia dotyczące podejścia do synchronizacji początkowej. W poniższej tabeli opisano zalecenia.

Zalecenie Opis
Pełna synchronizacja Dane istnieją tylko w Business Central lub tylko w Dataverse. Zaleca się synchronizację wszystkich danych z usługi, która je ma, z inną usługą.
Brak synchronizacji Dane istnieją w obu aplikacjach, a uruchomienie pełnej synchronizacji zduplikowałoby dane. Zaleca się parowanie rekordów.
Zależność niezaspokojona Dane istnieją w obu aplikacjach, ale nie można zsynchronizować wiersza lub tabeli, ponieważ zależy to od wiersza lub tabeli, która ma zalecenie Brak synchronizacji. Na przykład, jeśli nie można zsynchronizować klientów, nie można również zsynchronizować danych kontaktów zależnych od danych klienta.
Ważny

Zazwyczaj pełna synchronizacja jest używana tylko podczas pierwszej integracji aplikacji i tylko jedna aplikacja zawiera dane. Pełna synchronizacja może być przydatna w środowisku demonstracyjnym, ponieważ automatycznie tworzy i paruje rekordy w każdej aplikacji, co przyspiesza rozpoczęcie pracy z zsynchronizowanymi danymi. Pełną synchronizację należy jednak uruchomić tylko wtedy, gdy ma być jeden wiersz w Business Central dla każdego wiersza w Dataverse dla mapowań tabel. W przeciwnym razie wynikiem mogą być zduplikowane rekordy.

  1. Wybierz Żarówka otwierająca funkcję Powiedz mi.ikonę, wprowadź Assisted Setup, a następnie wybierz powiązane łącze.
  2. Wybierz pozycję Skonfiguruj połączenie z usługą Microsoft Dataverse, aby uruchomić przewodnik konfiguracji wspomaganej.
  3. W razie potrzeby wypełnij pola.
Uwaga

Jeśli nie zostanie wyświetlony monit o zalogowanie się przy użyciu konta administratora, prawdopodobnie jest to spowodowane zablokowaniem wyskakujących okienek. Aby się zalogować, zezwól na wyskakujące okienka z https://login.microsoftonline.com.

Aby ręcznie utworzyć lub utrzymać połączenie

Poniższa procedura opisuje sposób ręcznego konfigurowania połączenia na stronie Ustawienia połączenia Dataverse. Jest to również strona, na której zarządzasz ustawieniami integracji.

  1. Wybierz Żarówka otwierająca funkcję Powiedz mi.ikonę, wprowadź Dataverse Connection Setup, a następnie wybierz powiązane łącze.

  2. Wprowadź następujące informacje dotyczące połączenia z Business Central do Dataverse.

    Pole Opis
    Adres URL środowiska Jeśli posiadasz środowiska w Dataverse, znajdziemy je dla Ciebie po uruchomieniu przewodnika konfiguracji. Jeśli chcesz połączyć się z innym środowiskiem w innej dzierżawie, możesz wprowadzić poświadczenia administratora dla tego środowiska, a my je odkryjemy.
    Włączone Zacznij korzystać z integracji. Jeśli połączenie nie zostanie teraz skonfigurowane, ustawienia połączenia zostaną zapisane, ale użytkownicy nie będą mogli uzyskać dostępu do danych Dataverse z Business Central. Możesz wrócić do tej strony i włączyć połączenie później.

  3. W polu Model własności wybierz, czy tabela zespołu w Dataverse ma posiadać nowe rekordy, czy też jednego lub więcej określonych użytkowników. W przypadku wybraniaopcji Osoba należy określić każdego użytkownika. W przypadku wybrania opcji Zespółdomyślna jednostka biznesowa będzie wyświetlana w polu Sprzężona jednostka biznesowa.

  4. Aby przetestować ustawienia połączenia, wybierz pozycję Połączenie, a następnie pozycję Testuj połączenie.

    Uwaga

    Jeśli szyfrowanie danych nie jest włączone w Business Central, zostaniesz zapytany, czy chcesz je włączyć. Aby włączyć szyfrowanie danych, wybierz opcję Tak i podaj wymagane informacje. W przeciwnym razie wybierz opcję Nie. Szyfrowanie danych można włączyć później. Aby uzyskać więcej informacji, zobacz Szyfrowanie danych w Dynamics 365 Business Central w pomocy dla deweloperów i administracji.

  5. Jeśli synchronizacja Dataverse nie jest jeszcze skonfigurowana, zostaniesz zapytany, czy chcesz użyć domyślnej konfiguracji synchronizacji. W zależności od tego, czy chcesz zachować wyrównanie rekordów w Dataverse i Business Central, wybierz opcję Tak lub Nie.

Dostosowywanie sprzężenia opartego na dopasowaniu

Począwszy od 2021 release wave 2, można parowanie rekordów w Business Central i Dataverse na podstawie kryteriów dopasowania zdefiniowanych przez administratora.

Algorytm dopasowywania rekordów można uruchomić z następujących miejsc w Business Central:

  • Wyświetl strony, które pokazują rekordy, które są zsynchronizowane z Dataverse, takie jak strony Klienci i Towary.

    Zaznacz wiele rekordów, a następnie wybierz akcję Powiązane, wybierz pozycję Dataverse, wybierz pozycję Sprzężenie, a następnie wybierz pozycję Sprzężenie oparte na dopasowaniu.

    Po uruchomieniu procesu sprzężenia opartego na dopasowaniu z listy danych podstawowych zadanie sprzężenia zostanie zaplanowane zaraz po wybraniu kryteriów sprzężenia.

  • Pełna synchronizacja Dataverse. Strona recenzji.

    Gdy proces pełnej synchronizacji wykryje, że rekordy nie są rozsprzężone zarówno w Business Central, jak i w Dataverse, pojawi się łącze Wybierz kryteria sprzężenia dla odpowiedniej tabeli integracji.

    Możesz rozpocząć proces Uruchom pełną synchronizację ze stron Konfiguracja połączenia Dataverse i Konfiguracja połączenia Dynamics 365 i można go zainicjować jako krok w przewodniku Konfigurowanie połączenia z dataverse asystowanej konfiguracji, gdy zdecydujesz się ukończyć instalację i uruchomić pełną synchronizację na końcu.

    Po uruchomieniu procesu sprzężenia opartego na dopasowaniu z Dataverse Full Synch. Przejrzyj stronę, zadanie sprzężenia zostanie zaplanowane zaraz po zakończeniu konfiguracji.

  • Lista Mapowania tabel integracji.

    Zaznacz mapowanie, wybierz akcję Sprzężenie, a następnie wybierz opcję Sprzężenie oparte na dopasowaniu.

    Gdy proces sprzężenia opartego na dopasowaniu zostanie uruchomiony z mapowania tabeli integracji, zadanie sprzężenia zostanie uruchomione dla wszystkich niesprzężonych rekordów w tym mapowaniu. Jeśli został uruchomiony dla zestawu wybranych rekordów z listy, zostanie uruchomiony tylko dla wybranych rekordów niesprząsowanych.

We wszystkich trzech przypadkach zostanie otwarta strona Wybierz kryteria sprzężenia, aby można było zdefiniować odpowiednie kryteria sprzężenia. Na tej stronie dostosuj sprzężenie za pomocą następujących zadań:

  • Wybierz pola, które mają być zgodne z rekordami Business Central i jednostkami Dataverse, a także wybierz, czy dopasowanie w tym polu będzie rozróżniać wielkość liter, czy nie.

  • Określ, czy synchronizacja ma być uruchamiana po sprzężeniu rekordów, a jeśli rekord używa mapowania dwukierunkowego, wybierz również, co się stanie, jeśli konflikty są wymienione na stronie Rozwiązywanie konfliktów aktualizacji.

  • Nadaj priorytet kolejności wyszukiwania rekordów, określając priorytet dopasowania dla odpowiednich pól mapowania. Priorytety dopasowania sprawiają, że algorytm wyszukuje dopasowanie w wielu iteracjach zdefiniowanych przez wartości pola Priorytet dopasowania w porządku rosnącym. Pusta wartość w polu Priorytet dopasowania jest interpretowana jako priorytet 0, więc pola z tą wartością wypełniają się jako pierwsze.

  • Określ, czy utworzyć nowe wystąpienie encji w Dataverse na wypadek, gdyby nie można było znaleźć unikatowego niesprząsowanego dopasowania przy użyciu kryteriów dopasowania. Aby aktywować tę funkcję, wybierz akcję Utwórz nowy, jeśli nie można znaleźć dopasowania.

Wyświetlanie wyników zadania sprzężenia

Aby wyświetlić wyniki zadania sprzężenia, otwórz stronę Mapowania tabel integracji, wybierz odpowiednie mapowanie, wybierz akcję Sprzężenie, a następnie wybierz akcję Dziennik zadań sprzężenia integracji.

Jeśli istnieją rekordy, które nie zostały sprzężone, można przejść do szczegółów wartości w kolumnie Niepowodzenie, co spowoduje otwarcie listy błędów określającej, dlaczego rekordy nie zostały połączone.

Nieudane sprzężenie często występuje w następujących przypadkach:

  • Nie zdefiniowano kryteriów dopasowania

    W takim przypadku uruchom ponownie sprzężenie oparte na dopasowaniu, ale pamiętaj o zdefiniowaniu kryteriów sprzężenia.

  • Nie znaleziono dopasowania dla wielu rekordów na podstawie wybranych pasujących pól

    W takim przypadku powtórz sprzężenie z innymi pasującymi polami.

  • Znaleziono wiele dopasowań dla wielu rekordów na podstawie wybranych pasujących pól

    W takim przypadku powtórz sprzężenie z innymi pasującymi polami.

  • Znaleziono pojedyncze dopasowanie, ale pasujący rekord jest już powiązany z innym rekordem w Business Central

    W takim przypadku powtórz sprzężenie z innymi pasującymi polami lub zbadaj, dlaczego ta jednostka Dataverse jest sprzężona z tym innym rekordem w Business Central.

Wskazówka

Aby ułatwić uzyskanie przeglądu postępu sprzężenia, pole Sprzężone z Dataverse pokazuje, czy określony rekord jest sprzężony z jednostką Dataverse, czy nie. Listę rekordów, które są synchronizowane z Dataverse, można filtrować za pomocą tego pola.

Uaktualnianie usługi Connections z usługi Business Central Online do uwierzytelniania opartego na certyfikatach

Uwaga

Ta sekcja dotyczy tylko dzierżawców online Business Central hostowanych przez firmę Microsoft. Nie ma to wpływu na dzierżawców online hostowanych przez niezależnych dostawców oprogramowania ani na instalacje lokalne.

W kwietniu 2022 r. dataverse wycofa typ uwierzytelniania usługi Office365 (nazwa użytkownika/hasło). Aby uzyskać więcej informacji, zobacz Wycofywanie typu uwierzytelniania usługi Office365. Ponadto w marcu 2022 r. Business Central wycofa korzystanie z uwierzytelniania między usługami szyfrowanymi klientów dla dzierżawców online i będzie wymagać użycia uwierzytelniania między usługami opartego na certyfikatach dla połączeń z Dataverse. Dzierżawcy online Business Central, którzy są obsługiwani przez niezależnych dostawców oprogramowania i instalacje lokalne, mogą nadal używać tajnego uwierzytelniania klienta do łączenia się z Dataverse.

Aby uniknąć zakłócania integracji, należy uaktualnić połączenie do uwierzytelniania opartego na certyfikatach. Chociaż zmiana jest zaplanowana na marzec 2022 r., Zdecydowanie zalecamy jak najszybsze uaktualnienie. W poniższych krokach opisano sposób uaktualniania do uwierzytelniania opartego na certyfikatach.

Aby uaktualnić połączenie online Business Central do korzystania z uwierzytelniania opartego na certyfikatach

Uwaga

Uwierzytelnianie oparte na certyfikatach jest dostępne w programie Business Central 2021 w wersji 1 i nowszych. Jeśli używasz wcześniejszej wersji, musisz zaplanować aktualizację do Business Central 2021 release wave 1 przed marcem 2022 r. Aby uzyskać więcej informacji, zobacz Planowanie aktualizacji. Jeśli wystąpią problemy, skontaktuj się ze swoim partnerem lub pomocą techniczną.

  1. W centrum administracyjnym Business Centralsprawdź, czy używasz business central 2021 w wersji 1 lub nowszej (wersja 18 lub nowsza).
  2. W zależności od tego, czy integrujesz się z Dynamics 365 Sales, wykonaj jedną z następujących czynności:
    • Jeśli tak, otwórz stronę Konfiguracja połączenia Microsoft Dynamics 365.
    • Jeśli tego nie zrobisz, otwórz stronę Ustawienia połączenia Dataverse.
  3. Wybierz pozycję Połączenie, a następnie użyj uwierzytelniania certyfikatu, aby uaktualnić połączenie do uwierzytelniania opartego na certyfikatach.
  4. Zaloguj się przy użyciu poświadczeń administratora dla Dataverse. Logowanie powinno zająć mniej niż minutę.
Uwaga

Musisz powtórzyć te kroki w każdym środowisku Business Central, w tym zarówno w środowisku produkcyjnym, jak i w piaskownicy, oraz w każdej firmie, w której masz połączenie z Dataverse.

Podłączanie wersji lokalnych

Aby połączyć Business Central lokalnie z Dataverse, należy określić pewne informacje na stronie Konfiguracja połączenia Dataverse.

Jeśli chcesz nawiązać połączenie przy użyciu konta usługi Azure Active Directory (Azure AD), musisz zarejestrować aplikację w usłudze Azure AD i podać identyfikator aplikacji, klucz tajny magazynu kluczy oraz adres URL przekierowania, który ma być używany. Adres URL przekierowania jest wstępnie wypełniony i powinien działać w większości instalacji. Należy skonfigurować instalację do korzystania z protokołu HTTPS. Aby uzyskać więcej informacji, zobacz Konfigurowanie protokołu SSL do zabezpieczania połączenia klienta sieci Web Business Central. Jeśli konfigurujesz serwer tak, aby miał inną stronę główną, zawsze możesz zmienić adres URL. Klucz tajny klienta zostanie zapisany jako zaszyfrowany ciąg w bazie danych.

Warunki wstępne

Dataverse musi używać jednego z następujących typów uwierzytelniania:

Aby zarejestrować aplikację w usłudze Azure AD na potrzeby łączenia się z Business Central do Dataverse

W poniższych krokach założono, że używasz usługi Azure AD do zarządzania tożsamościami i dostępem. Aby uzyskać więcej informacji na temat rejestrowania aplikacji w usłudze Azure AD, zobacz Szybki start:Formore information about registering an application in Azure AD, see Quickstart: Zarejestruj aplikację za pomocą platformy tożsamości firmy Microsoft.

  1. W witrynie Azure Portal w obszarze Zarządzaj w okienku nawigacji wybierz pozycję Uwierzytelnianie.

  2. W obszarze Adresy URL przekierowańdodaj adres URL przekierowania sugerowany na stronie Konfiguracja połączenia Dataverse w Business Central.

  3. W obszarze Zarządzajwybierz pozycję Uprawnienia interfejsu API.

  4. W obszarze Skonfigurowane uprawnieniawybierz pozycję Dodaj uprawnienie, a następnie dodaj delegowane uprawnienia na karcie Interfejsy API firmy Microsoft w następujący sposób:

    • W przypadku Business Central dodaj uprawnienia Financials.ReadWrite.All.
    • W przypadku dynamics CRM dodaj uprawnienia user_impersonation.
    Uwaga

    Nazwa interfejsu API Dynamics CRM może ulec zmianie.

  5. W obszarze Zarządzajwybierz pozycję Certyfikatyi wpisy tajne , a następnie utwórz nowy klucz tajny dla aplikacji. Klucz tajny będzie używany w Business Central, w polu Klucz tajny klienta na stronie Konfiguracja połączenia Dataverse lub w bezpiecznym magazynie i udostępniany subskrybentowi zdarzenia zgodnie z opisem we wcześniejszej części tego tematu.

  6. Wybierz pozycję Przegląd, a następnie znajdź wartość Identyfikator aplikacji (klienta). Jest to identyfikator klienta aplikacji. Należy go wprowadzić na stronie Ustawienia połączenia Dataverse w polu Identyfikator klienta lub zapisać w bezpiecznym magazynie i udostępnić subskrybentowi zdarzenia.

  7. W Business Central na stronie Dataverse Connection Setup (Konfiguracja połączenia Dataverse) w polu Adres URL środowiska wprowadź adres URL środowiska Dataverse.

  8. Aby włączyć połączenie z Dataverse, włącz przełącznik Włączone.

  9. Zaloguj się przy użyciu konta administratora usługi Azure Active Directory (to konto musi mieć ważną licencję na Usługę Dataverse i być administratorem w środowisku Dataverse). Po zalogowaniu się zostanie wyświetlony monit o zezwolenie zarejestrowanej aplikacji na zalogowanie się do Dataverse w imieniu organizacji. Musisz wyrazić zgodę na ukończenie konfiguracji.

    Uwaga

    Jeśli monit o zalogowanie się przy użyciu konta administratora nie jest wyświetlany, prawdopodobnie jest to spowodowane zablokowaniem wyskakujących okienek. Aby się zalogować, zezwól na wyskakujące okienka z https://login.microsoftonline.com.

Aby rozłączyć się z Dataverse

  1. Wybierz Żarówka otwierająca funkcję Powiedz mi.ikonę, wprowadź Dataverse Connection Setup, a następnie wybierz powiązane łącze.
  2. Na stronie Dataverse Connection Setup (Konfiguracja połączenia Dataverse) wyłącz przełącznik Enabled (Włączone).

Zobacz też

Wyświetlanie stanu synchronizacji