© navision.pl | Opracowano na podstawie: Microsoft Learn (CC BY 4.0)

Łączenie z Microsoft Dataverse

Ten artykuł opisuje, jak skonfigurować połączenie między Business Central a Dataverse. Zazwyczaj firmy tworzą połączenie w celu integracji i synchronizacji danych z inną aplikacją Dynamics 365, taką jak Dynamics 365 Sales.

Zanim zaczniesz

Przed utworzeniem połączenia należy przygotować kilka informacji:

• Adres URL środowiska Dataverse, z którym chcesz się połączyć. Jeśli używasz przewodnika asystowanej konfiguracji Konfiguracja połączenia Dataverse do utworzenia połączenia, znajdziemy Twoje środowiska za Ciebie. Możesz również wprowadzić adres URL innego środowiska w Twojej dzierżawie.
• Nazwa użytkownika i hasło konta z uprawnieniami administratora w Business Central i Dataverse.
• Jeśli masz lokalną wersję Business Central 2020 release wave 1, wersja 16.5, przeczytaj artykuł Some Known Issues. Wykonaj opisane obejście przed utworzeniem połączenia z Dataverse.
• Waluty lokalne używane przez każdą firmę. Firmy Business Central mogą łączyć się ze środowiskiem Dataverse, które ma walutę bazową inną niż ich waluta lokalna. Aby dowiedzieć się więcej o obsłudze konfiguracji wielowalutowych, przejdź do Zezwalanie na różne waluty.

Ostrzeżenie

Twoje środowisko Dataverse nie może być w trybie administracji. Tryb administracji powoduje niepowodzenie połączenia, ponieważ konto użytkownika integracji dla połączenia nie ma uprawnień administratora. Dowiedz się więcej w Administration mode.

Uwaga

These steps describe the procedure for Business Central online. If you're using Business Central on-premises and aren't using a Microsoft Entra account to connect to Dataverse, you must also specify a user name and password of a user account for the integration. This account is referred to as the "integration user" account. If you're using a Microsoft Entra account, the integration user account isn't required or displayed. The integration user will be set up automatically and doesn't require a license.

Łączenie środowisk Business Central i Dataverse

Firmy chcą zachować bezpieczeństwo swoich danych w granicach prywatności, szczególnie gdy ich aplikacja do zarządzania biznesem integruje się z innymi aplikacjami. Połączenie między środowiskami Business Central i Dataverse pomaga osiągnąć te cele. Ponadto zapewniasz swoim administratorom łatwiejszy sposób tworzenia i utrzymywania integracji z innymi aplikacjami Dynamics 365.

W centrum administracyjnym Business Central możesz połączyć swoje środowisko Business Central ze środowiskiem Dataverse. Business Central może wykorzystać informacje z tego połączenia, aby ułatwić i zabezpieczyć integrację z innymi aplikacjami Dynamics 365, takimi jak Sales i Pole Service. Na przykład adres URL połączonego środowiska Dataverse jest domyślnie dostępny na stronie Konfiguracja połączenia Dataverse oraz podczas uruchamiania przewodnika asystowanej konfiguracji Konfiguracja połączenia Dataverse.

Allow for different currencies

Firmy Business Central mogą łączyć się ze środowiskiem Dataverse, które ma walutę podstawową inną niż ich waluta lokalna.

Uwaga

Synchronizacja wielu walut wymaga użycia synchronizacji jednokierunkowej, z Business Central do Dataverse.

Aby dowiedzieć się więcej o walucie podstawowej w Dataverse, przejdź do Transaction Currency (currency) entity.

Aby dowiedzieć się więcej o walutach w Business Central, przejdź do Waluty w Business Central.

Aby zezwolić na różne waluty, przed połączeniem upewnij się, że określono następujące ustawienia:

• Ustawienie podstawowej waluty transakcji w Dataverse ma kod waluty, który znajduje się na stronie Waluty w Business Central.
• Na stronie Kursy wymiany walut w Business Central określono co najmniej jeden kurs wymiany dla waluty.

Po włączeniu połączenia z Dataverse, Business Central dodaje swoją walutę lokalną do encji Waluta w Dataverse. Waluta lokalna używa kursu wymiany z pola Współczynnik waluty na stronie Kursy wymiany walut.

Ponieważ synchronizacja walut jest jednokierunkowa, z Business Central do Dataverse, kwoty pieniężne są konwertowane i synchronizowane w następujący sposób:

• Jeśli kwoty są w walucie podstawowej Dataverse, są konwertowane na walutę lokalną Business Central na podstawie najnowszego kursu wymiany zsynchronizowanego z Business Central.
• Jeśli kwoty są w walucie lokalnej Business Central, są synchronizowane z walutą lokalną Business Central jako jedna z dodatkowych, niepodstawowych walut w Dataverse.

Konfigurowanie połączenia z Dataverse

Dla wszystkich typów uwierzytelniania innych niż uwierzytelnianie Microsoft 365, połączenie z Dataverse konfigurujesz na stronie Konfiguracja połączenia Dataverse. W przypadku uwierzytelniania Microsoft 365 zalecamy użycie przewodnika asystowanej konfiguracji Konfiguracja połączenia Dataverse. Przewodnik ułatwia skonfigurowanie połączenia i określenie zaawansowanych funkcji, takich jak model własności i synchronizacja początkowa.

Ostrzeżenie

During the setup of the connection to Dataverse, administrators are asked to give following permissions to a registered Azure application named Business Central Integration to Dataverse: * Access Dataverse as you permission is needed so Business Central can, on behalf of administrator, automatically create nonlicensed non-interactive Business Central Integration application user, assign security roles to this user and to deploy Business Central Integration Solution to Dataverse. This permission is used only one time to set up the connection to Dataverse.
Have full access to Dynamics 365 Business Central permission is needed so the automatically created Business Central Integration application user can access Business Central data that synchronizes.
Sign in and read your profile permission is needed to verify user logging in actually has System Administrator security role assigned in Dataverse.
By giving consent on behalf of organization, the administrator is entitling the registered Azure application called Business Central Integration to Dataverse to synchronize data using automatically created Business Central Integration application user's credentials.

Aby użyć przewodnika asystowanej konfiguracji Konfiguracja połączenia Dataverse

Przewodnik Konfiguracja połączenia Dataverse może ułatwić połączenie aplikacji, a nawet pomóc w przeprowadzeniu synchronizacji początkowej. Jeśli zdecydujesz się uruchomić synchronizację początkową, Business Central przegląda dane w obu aplikacjach i przedstawia 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. Zaleceniem jest zsynchronizowanie wszystkich danych z usługi, która je posiada, do drugiej usługi.
Brak synchronizacji	Dane istnieją w obu aplikacjach, a uruchomienie pełnej synchronizacji spowodowałoby zduplikowanie danych. Zaleceniem jest sprzęgnięcie rekordów.
Zależność niespełniona	Dane istnieją w obu aplikacjach, ale wiersz lub tabela nie może się zsynchronizować, ponieważ zależy od wiersza lub tabeli, dla której obowiązuje zalecenie Brak synchronizacji. Na przykład, jeśli nabywcy nie mogą się zsynchronizować, dane kontaktów zależne od danych nabywców również nie mogą się zsynchronizować.

Ostrzeżenie

Zwykle 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 sprzęga rekordy w każdej aplikacji, co przyspiesza rozpoczęcie pracy z zsynchronizowanymi danymi. Należy jednak uruchamiać pełną synchronizację tylko wtedy, gdy chcesz mieć jeden wiersz w Business Central dla każdego wiersza w Dataverse dla mapowań tabel. W przeciwnym razie wynikiem mogą być zduplikowane rekordy.

1. Wybierz Szukaj (Alt+Q) w prawym górnym rogu, wprowadź Asystowana konfiguracja, a następnie wybierz powiązane łącze.
2. Wybierz Skonfiguruj połączenie z Microsoft Dataverse, aby uruchomić przewodnik asystowanej konfiguracji.
3. Wypełnij pola zgodnie z potrzebami.

Uwaga

Jeśli nie zostaniesz poproszony o zalogowanie się za pomocą konta administratora, prawdopodobnie wyskakujące okienka są zablokowane. 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, jak ręcznie skonfigurować połączenie na stronie Konfiguracja połączenia Dataverse. Strona Konfiguracja połączenia Dataverse służy do zarządzania ustawieniami integracji.

1. Wybierz Szukaj (Alt+Q) w prawym górnym rogu, wprowadź Konfiguracja połączenia Dataverse, 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 podczas uruchamiania przewodnika konfiguracji. Jeśli chcesz połączyć się z innym środowiskiem w innym dzierżawcy, możesz wprowadzić poświadczenia administratora dla tego środowiska, a my je również znajdziemy.
   Włączone	Zacznij korzystać z integracji. Jeśli nie włączysz teraz połączenia, 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ć na tę stronę i włączyć połączenie później.

3. W polu Model własności wybierz, czy chcesz, aby nowe rekordy były własnością tabeli zespołu w Dataverse, czy jednego lub więcej określonych użytkowników. Jeśli wybierzesz Osoba, musisz określić każdego użytkownika. Jeśli wybierzesz Zespół, domyślna jednostka biznesowa zostanie wyświetlona w polu Sprzęgnięta jednostka biznesowa.

   4. Aby przetestować ustawienia połączenia, wybierz Połączenie, a następnie 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 Tak i podaj wymagane informacje. W przeciwnym razie wybierz Nie. Szyfrowanie danych możesz włączyć później. Aby uzyskać więcej informacji, zobacz Encrypting Data in Dynamics 365 Business Central w pomocy dla deweloperów i administratorów. 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 Tak lub Nie.

Dostosowywanie sprzęgania opartego na dopasowaniu

Administratorzy mogą wprowadzić kryteria parowania rekordów na podstawie dopasowań. Algorytm dopasowywania rekordów można uruchomić z następujących miejsc w Business Central:

• Strony listy pokazujące rekordy synchronizowane z Dataverse, takie jak strony Nabywcy i Zapasy.

  Zaznacz wiele rekordów, a następnie wybierz akcję Powiązane, wybierz Dataverse, wybierz Parowanie, a następnie wybierz Parowanie na podstawie dopasowania.

  Po uruchomieniu procesu parowania na podstawie dopasowania z listy danych głównych zadanie parowania jest planowane po określeniu kryteriów parowania.
  Strona Przegląd pełnej synchronizacji Dataverse*.

  Gdy proces pełnej synchronizacji wykryje niesparowane rekordy w Business Central i Dataverse, dla tabeli integracji pojawia się link Wybierz kryteria parowania.

  Proces Uruchom pełną synchronizację można uruchomić ze stron Ustawienia połączenia Dataverse i Ustawienia połączenia Dynamics 365. Można go również uruchomić w przewodniku instalacji wspomaganej Skonfiguruj połączenie z Dataverse po zakończeniu konfiguracji.

  Po uruchomieniu procesu parowania na podstawie dopasowania ze strony Przegląd pełnej synchronizacji Dataverse zadanie parowania jest planowane po zakończeniu konfiguracji.
  Lista Mapowania tabel integracji*.

  Wybierz mapowanie, wybierz akcję Parowanie, a następnie wybierz Parowanie na podstawie dopasowania.

  Po uruchomieniu procesu parowania na podstawie dopasowania z mapowania tabeli integracji zadanie parowania jest uruchamiane dla wszystkich niesparowanych rekordów w mapowaniu. Można również wybrać niesparowane rekordy na liście, aby uruchomić zadanie tylko dla tych rekordów.

We wszystkich trzech przypadkach otwiera się strona Wybierz kryteria parowania, umożliwiająca zdefiniowanie odpowiednich kryteriów parowania. Na tej stronie można dostosować parowanie za pomocą następujących zadań:

• Wybierz pola używane do dopasowywania rekordów Business Central z encjami Dataverse. Można określić, czy dopasowanie ma uwzględniać wielkość liter.

• Określ, czy synchronizować po sparowaniu rekordów. Jeśli rekordy używają mapowania dwukierunkowego, można również określić, co się stanie, gdy konflikty są wymienione na stronie Rozwiąż konflikty aktualizacji.

• Ustaw priorytet kolejności wyszukiwania rekordów, określając priorytet dopasowania dla odpowiednich pól mapowania. Business Central szuka dopasowania w kolejności rosnącej na podstawie wartości w polu Priorytet dopasowania. Pusta wartość w polu Priorytet dopasowania odpowiada priorytetowi 0, który jest najwyższym priorytetem. Pola z priorytetem 0 są rozpatrywane jako pierwsze.

• Określ, czy utworzyć nowe wystąpienie encji w Dataverse, jeśli nie można znaleźć unikatowego niesparowanego 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 parowania

Aby wyświetlić wyniki zadania parowania, otwórz stronę Mapowania tabel integracji, wybierz odpowiednie mapowanie, wybierz akcję Parowanie, a następnie wybierz akcję Dziennik zadań parowania integracji.

Jeśli parowanie rekordów nie powiodło się, można wybrać wartość w kolumnie Niepowodzenie, aby otworzyć listę błędów opisujących przyczynę.

Jeśli parowanie nie powiedzie się, zwykle jest to spowodowane jedną z następujących przyczyn:

• Nie zdefiniowano kryteriów dopasowania

  Uruchom ponownie parowanie na podstawie dopasowania, ale pamiętaj o zdefiniowaniu kryteriów parowania.

• Nie znaleziono dopasowania dla pól określonych w kryteriach dopasowania

  Powtórz parowanie, używając innych pól.

• Znaleziono wiele dopasowań dla kilku rekordów na podstawie pól określonych w kryteriach dopasowania

  Powtórz parowanie, używając innych pól.

• Znaleziono dopasowanie, ale rekord jest już sparowany z rekordem w Business Central

  Powtórz parowanie, używając innych pól, lub sprawdź, dlaczego encja Dataverse jest sparowana z rekordem w Business Central.

Porada

Aby ułatwić uzyskanie przeglądu postępu parowania, pole Sparowane z Dataverse pokazuje, czy rekord jest sparowany z encją Dataverse. Pole Sparowane z Dataverse można użyć do filtrowania listy synchronizowanych rekordów.

Uaktualnianie połączeń z Business Central Online w celu użycia uwierzytelniania opartego na certyfikatach

Uwaga

Ta sekcja dotyczy tylko dzierżaw online Business Central hostowanych przez Microsoft. Dzierżawy online hostowane przez niezależnych dostawców oprogramowania i instalacje lokalne nie są objęte tą zmianą.

W kwietniu 2022 r. Dataverse wycofał typ uwierzytelniania Office365 (nazwa użytkownika/hasło). Więcej informacji można znaleźć w artykule Deprecation of Office365 authentication type. Ponadto w marcu 2022 r. Business Central wycofał używanie uwierzytelniania typu usługa-usługa opartego na kluczu tajnym klienta dla dzierżaw online. Do połączeń z Dataverse należy używać uwierzytelniania typu usługa-usługa opartego na certyfikatach. Dzierżawy online Business Central hostowane przez niezależnych dostawców oprogramowania oraz instalacje lokalne mogą nadal używać kluczy tajnych klienta do uwierzytelniania.

Aby uniknąć zakłóceń w integracjach, musisz uaktualnić połączenie, aby używać uwierzytelniania opartego na certyfikatach. Poniższe kroki opisują, jak uaktualnić do uwierzytelniania opartego na certyfikatach.

Aby uaktualnić połączenie Business Central Online w celu użycia uwierzytelniania opartego na certyfikatach

1. W zależności od tego, czy integrujesz się z Dynamics 365 Sales, wykonaj jedną z następujących czynności:
2. Jeśli tak, otwórz stronę Ustawienia połączenia Microsoft Dynamics 365.
3. Jeśli nie, otwórz stronę Ustawienia połączenia Dataverse.
4. Wybierz Połączenie, a następnie Użyj uwierzytelniania certyfikatem, aby uaktualnić połączenie do uwierzytelniania opartego na certyfikatach.
5. Zaloguj się przy użyciu poświadczeń administratora Dataverse. Logowanie powinno zająć mniej niż minutę.

Uwaga

Te kroki należy powtórzyć w każdym środowisku Business Central, w tym w środowiskach produkcyjnych i piaskownicach, oraz w każdej firmie, w której masz połączenie z Dataverse.

Łączenie wersji lokalnych

Aby połączyć lokalną wersję Business Central z Dataverse, należy podać pewne informacje na stronie Ustawienia połączenia Dataverse.

Aby połączyć się przy użyciu konta Microsoft Entra, należy zarejestrować aplikację w Microsoft Entra ID. Należy podać identyfikator aplikacji, klucz tajny magazynu kluczy i adres URL przekierowania do użycia. Adres URL przekierowania jest wstępnie wypełniony i powinien działać w większości instalacji. Instalację należy skonfigurować do używania protokołu HTTPS. Więcej informacji można znaleźć w artykule Configuring SSL to Secure the Business Central Web Client Connection. Jeśli konfigurujesz serwer z inną stroną główną, możesz zmienić adres URL. Klucz tajny klienta jest zapisywany jako zaszyfrowany ciąg w bazie danych.

Aby zarejestrować aplikację w Microsoft Entra ID w celu połączenia z Business Central do Dataverse

Poniższe kroki zakładają, że używasz Microsoft Entra ID do zarządzania tożsamościami i dostępem. Aby dowiedzieć się więcej o rejestrowaniu aplikacji w Microsoft Entra ID, przejdź do artykułu Quickstart: Register an application with the Microsoft identity platform.

1. W portalu Azure Portal, w sekcji Zarządzanie w okienku nawigacji, wybierz Uwierzytelnianie.
2. W sekcji Adresy URL przekierowania dodaj adres URL przekierowania sugerowany na stronie Ustawienia połączenia Dataverse w Business Central.
3. W sekcji Zarządzanie wybierz Uprawnienia interfejsu API.
4. W sekcji Skonfigurowane uprawnienia wybierz Dodaj uprawnienie, a następnie dodaj uprawnienia delegowane na karcie Interfejsy API Microsoft w następujący sposób:
   • Dla Business Central dodaj uprawnienia Financials.ReadWrite.All.
   • Dla Dataverse dodaj uprawnienia user_impersonation.

Uwaga

Nazwa interfejsu API Dynamics CRM może ulec zmianie.

1. W sekcji Zarządzaj wybierz Certyfikaty i wpisy tajne, a następnie utwórz nowy wpis tajny dla swojej aplikacji. Wpisu tajnego używasz w Business Central w polu Wpis tajny klienta na stronie Konfiguracja połączenia Dataverse lub przechowujesz go w bezpiecznym magazynie i udostępniasz w subskrybencie zdarzenia zgodnie z opisem we wcześniejszej części tego artykułu.
2. Wybierz Przegląd, a następnie znajdź wartość Identyfikator aplikacji (klienta). Ten identyfikator jest identyfikatorem klienta Twojej aplikacji. Musisz wprowadzić go na stronie Konfiguracja połączenia Dataverse w polu Identyfikator klienta lub przechować w bezpiecznym magazynie i udostępnić w subskrybencie zdarzenia.
3. W Business Central na stronie Konfiguracja połączenia Dataverse w polu Adres URL środowiska wprowadź adres URL środowiska Dataverse.
4. Aby włączyć połączenie z Dataverse, włącz przełącznik Włączone.
5. Zaloguj się przy użyciu konta administratora Microsoft Entra ID (to konto musi mieć ważną licencję na Dataverse i być administratorem w środowisku Dataverse). Po zalogowaniu zostanie wyświetlony monit o zezwolenie zarejestrowanej aplikacji na logowanie się do Dataverse w imieniu organizacji. Musisz wyrazić zgodę, aby zakończyć konfigurację.

Uwaga

Jeśli nie pojawi się monit o zalogowanie się przy użyciu konta administratora, prawdopodobnie wyskakujące okienka są zablokowane. Aby się zalogować, zezwól na wyskakujące okienka z https://login.microsoftonline.com.

Aby rozłączyć się z Dataverse

1. Wybierz Szukaj (Alt+Q) w prawym górnym rogu, wprowadź Konfiguracja połączenia Dataverse, a następnie wybierz powiązane łącze.
2. Na stronie Konfiguracja połączenia Dataverse wyłącz przełącznik Włączone.

Powiązane informacje

Wyświetlanie stanu zadań synchronizacji

Znajdź bezpłatne moduły e-learningowe dla Business Central tutaj