Nawiązywanie połączenia z usługą Dataverse w celu synchronizacji danych
Uwaga
Microsoft Entra ID to nowa nazwa usługi Azure Active Directory. Dowiedz się więcej
W artykule opisano, jak skonfigurować połączenie między Business Central i Dataverse. Połączenie jest zazwyczaj tworzone przez firmy, aby zsynchronizować dane z inną aplikacją biznesową Dynamics 365, taką jak Dynamics 365 Sales.
Przed rozpoczęciem
Jest kilka ważnych informacji, które należy zgromadzić przed utworzeniem połączenia:
- Adres URL środowiska Dataverse, z którym ma być utworzone połączenie. Wyszukanie użytkowników korzystających z przewodnika konfiguracji z pomocą Ustawienia połączenia Dataverse do tworzenia połączenia jest bardzo proste. Można wprowadzić także adres URL innego środowiska w dzierżawcy użytkownika.
- Nazwa użytkownika i hasło konta posiadającego uprawnienia administratora w Business Central i Dataverse.
- Jeśli wykorzystywana jest lokalna wersja 16.5 Business Central 2020 release wave 1, warto przeczytać artykuł Niektóre znane problemy. Przed możliwością utworzenia połączenia z Dataverse będzie trzeba ukończyć opisane rozwiązanie.
- Lokalne waluty używane przez firmy. Firma może połączyć się w Business Central ze środowiskiem Dataverse, w którym waluta podstawowa różni się od jej waluty lokalnej. Dodatkowe informacje na temat obsługi wielu walut zamieszczono w sekcji Obsługa wielu walut.
Ważne
Środowisko Dataverse nie może być w trybie administracji. Tryb administracji spowoduje błąd połączenia, ponieważ konto użytkownika integracyjnego nie posiada uprawnień administratora. Dodatkowe informacje zamieszczono w artykule Tryb administracji.
Uwaga
W poniższych krokach opisano procedurę dla Business Central online. Użytkownik korzystający z wersji Business Central on-premises niełączący się z Dataverse za pomocą konta Microsoft Entra, powinien określić również nazwę użytkownika i hasło konta do integracji. Konto jest nazywane kontem „użytkownika integracyjnego”. Jeśli używane jest konto Microsoft Entra, konto użytkownika integracji nie jest ani wymagane, ani wyświetlane. Użytkownik integracyjny zostanie automatycznie skonfigurowany i nie potrzebuje licencji.
Obsługa wielu walut
Firma może połączyć się w Business Central ze środowiskiem Dataverse, w którym waluta podstawowa różni się od jej waluty lokalnej.
Uwaga
Synchronizacja wielu walut wymaga wykorzystania jednokierunkowej synchronizacji z Business Central do Dataverse.
Dodatkowe informacje na temat waluty podstawowej w Dataverse zamieszczono w artykule Jednostka waluty transakcji (waluta).
Dodatkowe informacje na temat walut w Business Central zamieszczono na stronie Waluty w Business Central.
Aby włączyć obsługę wielu walut przed połączeniem usług, należy upewnić się, że:
- podstawowa waluta transakcji w Dataverse zawiera kod waluty określony na stronie Waluty w Business Central,
- dla waluty w Business Central określono co najmniej jeden kurs wymiany na stronie Kursy wymiany walut.
Po skonfigurowaniu połączenia z Dataverse, Business Central doda walutę lokalną do jednostki Waluta w Dataverse. Waluta lokalna wykorzystuje kurs wymiany określony w polu Kurs wymiany na stronie Kursy wymiany walut.
Synchronizacja walut jest jednokierunkowa, z Business Central do Dataverse, a kwoty pieniężne są przeliczane i synchronizowane w następujący sposób:
- Kwoty w walucie bazowej Dataverse są konwertowane na walutę lokalną Business Central na podstawie najnowszego kursu wymiany zsynchronizowanego z Business Central.
- Kwoty w walucie lokalnej Business Central są synchronizowane z walutą lokalną Business Central w jednej z dodatkowych (niebazowych) walut w Dataverse.
Konfiguracja połączenia z Dataverse
Dla wszystkich typów uwierzytelniania innych niż uwierzytelnianie Microsoft 365, konfiguracja połączenia odbywa się w Dataverse, na stronie Ustawienia połączenia Dataverse. Rekomendowanym sposobem konfiguracji dla uwierzytelniania Microsoft 365 jest przewodnik konfiguracji z pomocą Ustawienia połączenia Dataverse. Poradnik ułatwia konfigurację połączenia i określenie zaawansowanych funkcji, takich jak model własności i synchronizacja początkowa.
Ważne
Podczas konfiguracji połączenia z Dataverse, administrator zostanie poproszony o nadanie następujących uprawnień zarejestrowanej aplikacji Azure, o nazwie Integracja Business Central z Dataverse:
- Uprawnienie Dostęp do Dataverse z konta użytkownika jest potrzebne, aby Business Central mogło automatycznie, w imieniu administratora, utworzyć nielicencjonowanego, nieinteraktywnego użytkownika aplikacji integracji Business Central, przypisać do użytkownika role zabezpieczeń i wdrożyć rozwiązanie integracji Business Central do Dataverse. Uprawnienie jest użyte tylko raz podczas konfiguracji połączenia z Dataverse.
- Uprawnienie Posiadaj pełny dostęp do Dynamics 365 Business Central jest potrzebne, aby automatycznie utworzony użytkownik aplikacji integracji Business Central miał dostęp do synchronizowanych danych Business Central.
- Uprawnienie Zaloguj się i odczytaj profil jest potrzebne do weryfikacji, czy logujący się użytkownik posiada, przypisaną w Dataverse, rolę administratora systemu.
Administrator, wyrażając zgodę w imieniu organizacji, upoważnia zarejestrowaną aplikację Azure o nazwie Integracja Business Central z Dataverse do synchronizacji danych z użyciem poświadczeń automatycznie utworzonego użytkownika aplikacji integracji Business Central.
Aby użyć przewodnik konfiguracji z pomocą Ustawienia połączenia Dataverse
Przewodnik Konfiguracja połączenia Dataverse może ułatwić połączenie aplikacji, a nawet pomóc w uruchomieniu synchronizacji początkowej. Uruchomienie synchronizacji początkowej sprawi, że Business Central sprawdzi dane w obu aplikacjach i zapewni rekomendacje na temat synchronizacji początkowej. W poniższej tabeli opisano rekomendacje.
| Rekomendacja | 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 posiada, do drugiej usługi. |
| Brak synchronizacji | Dane istnieją w obu aplikacjach, a uruchomienie pełnej synchronizacji spowodowałoby zduplikowanie danych. Zaleca się sprzężenie rekordów. |
| Warunek zależności nie został spełniony | Dane istnieją w obu aplikacjach, ale wiersze i tabele nie mogą zostać zsynchronizowane, ponieważ zależą od wiersza lub tabeli posiadającej rekomendację Brak synchronizacji. Na przykład, jeśli nabywcy nie mogą zostać zsynchronizowani, dane kontaktów, które zależą od danych klientów również nie mogą zostać zsynchronizowane. |
Ważne
Zazwyczaj pełna synchronizacja jest wykorzystywana tylko podczas pierwszej integracji aplikacji i tylko jedna z aplikacji zawiera dane. Pełna synchronizacja może być użyteczna w środowisku demonstracyjnym, ponieważ automatycznie tworzy i sprzęga rekordy w każdej z aplikacji, co przyspiesza rozpoczęcie pracy z zsynchronizowanymi danymi. Jednak pełna synchronizacja powinna być uruchamiana tylko jeśli jeden wiersz Business Central ma odpowiadać jednemu wierszowi w Dataverse w mapowaniu tabeli. W innym wypadku mogą pojawić się zduplikowane rekordy.
- Wybierz ikonę
, wprowadź Konfiguracja z pomocą, a następnie wybierz powiązane łącze. - Wybierz Włącz połączenie z Microsoft Dataverse, aby uruchomić przewodnik konfiguracji z pomocą.
- Wypełnij odpowiednio pola.
Uwaga
Jeśli system nie poprosił o zalogowanie się do konta administratora, należy sprawdzić, czy wyskakujące okienka nie są blokowane. Aby przejść do strony logowania, należy zezwolić na wyskakujące okienka na stronie Microsoft.
Aby ręcznie utworzyć lub podtrzymać połączenie
Poniższa procedura opisuje, jak ręcznie skonfigurować połącznie na stronie Ustawienia połączenia Dataverse. Zarządzanie ustawieniami jest możliwe na stronie Ustawienia połączenia Dataverse.
Wybierz ikonę
, wprowadź Ustawienia połączenia Dataverse, a następnie wybierz powiązane łącze.Poniższe informacje należy wprowadzić dla połączenia z Business Central do Dataverse.
Pole Opis Adres URL środowiska Posiadane środowiska Dataverse zostaną znalezione po uruchomieniu przewodnika konfiguracji. Aby połączyć się z innym środowiskiem w innym dzierżawcy, należy wprowadzić poświadczenia administratora danego środowiska, które pozwolą na jego rozpoznanie. Włączone Uruchomienie z wykorzystaniem integracji. Jeśli połączenie nie zostanie uruchomione w tym momencie, ustawienia połączenia zostaną zapisane, ale użytkownicy nie będą mieć dostępu do danych Dataverse z Business Central. Połączenie można uruchomić później, wracając na tę stronę. W polu Model własności, wybierz czy nowe rekordy mają należeć do tabeli zespołu czy do jednego lub wielu określonych użytkowników w Dataverse. Jeśli wybierzesz opcję Osoba, musisz określić każdego użytkownika. Jeśli wybierzesz opcję Zespół, domyślna jednostka organizacyjna zostanie wyświetlona w polu Sprzężona jednostka organizacyjna.
Aby przetestować ustawienia połączenia, wybierz Połączenie, a następnie Testuj połączenie.
Uwaga
Jeśli nie uruchomiono szyfrowania danych w Business Central, system zapyta czy funkcja ma zostać włączona. Aby włączyć szyfrowanie danych, należy wybrać Tak i uzupełnić wymagane informacje. W innym wypadku wybierz Nie. Szyfrowanie danych może zostać uruchomione później. Dodatkowe informacje zamieszczono w portalu pomocy dla programistów i administratorów, w sekcji Szyfrowanie danych w Dynamics 365 Business Central.
Jeśli synchronizacja Dataverse nie została dotychczas skonfigurowana, system zapyta czy chcesz użyć domyślnych ustawień synchronizacji. W zależności od tego, czy chcesz zachować dopasowanie rekordów w Dataverse oraz w Business Central, wybierz Tak lub Nie.
Dostosowywanie sprzężenia na podstawie dopasowań
W wydaniu 2021 release wave 2 administrator zyskał możliwość wprowadzenia kryteriów sprzężenia rekordów na podstawie dopasowań. Uruchomienie algorytmu dopasowania rekordów jest możliwe w Business Central w następujących miejscach:
Strony list, które pokazują rekordy zsynchronizowane z Dataverse, takie jak strony Nabywcy i Zapasy.
Wybierz powiązane rekordy, akcję Powiązane, potem Dataverse, Sprzężenie, a następnie Sprzężenie na podstawie dopasowań.
Zlecenie sprzężenia zostaje zaplanowane po rozpoczęciu procesu sprzężenia na podstawie dopasowań z listy danych podstawowych i określeniu kryteriów sprzężenia przez użytkownika.
Strona Pełen przegląd synchronizacji Dataverse.
Łącze Wybierz kryteria sprzężenia pojawia się dla tabeli integracji kiedy proces pełnej synchronizacji wykryje niesprzężone rekordy w Business Central i Dataverse.
Proces Uruchom pełną synchronizację można rozpocząć na stronach Ustawienia połączenia Dataverse oraz Ustawienia połączenia Dynamics 365. Jest to możliwe także w przewodniku konfiguracji z pomocą Skonfiguruj połączenie z Dataverse po ukończeniu konfiguracji.
Sprzężenie zostanie zaplanowane po ukończeniu procesu sprzężenia na podstawie dopasowań na stronie Pełen przegląd synchronizacji Dataverse.
Lista Mapowania tabeli integracji.
Wybierz mapowanie, a następnie akcje Sprzężenie oraz Sprzężenie na podstawie dopasowań.
Zlecenie sprzężenia na podstawie dopasowań z mapowania tabeli integracji dla wszystkich niesprzężonych rekordów w mapowaniu jest uruchamiane po rozpoczęciu procesu sprzężenia. Zlecenie można również uruchomić tylko dla wybranych niesprzężonych rekordów.
Definiowanie odpowiednich kryteriów sprzężenia jest możliwe we wszystkich powyższych przypadkach, po otwarciu strony Wybierz kryteria sprzężenia. Na tej stronie można wykorzystać trzy poniższe zadania ,aby dostosować sprzężenie:
Wybierz pola do dopasowania rekordów Business Central do jednostek Dataverse. Można określić, czy dopasowanie będzie brało pod uwagę wielkość liter.
Określ, czy rekordy należy zsynchronizować po sprzężeniu. Jeżeli rekordy wykorzystują mapowanie dwukierunkowe, można określić rezultat wyświetlenia konfliktów na stronie Rozwiąż konflikty uaktualniania.
Ustaw priorytet dla zamówienia, w którym wyszukiwanie rekordów dla odpowiednich pól mapowania zawiera priorytet dopasowania. Business Central wyszuka dopasowania w kolejności rosnącej na podstawie wartości w polu Dopasuj priorytet. Pusta wartość w polu Dopasuj priorytet równa się wartości priorytetu 0, który jest najwyższym priorytetem. Pola z priorytetem 0 są uwzględniane jako pierwsze.
Określ, czy nowe wystąpienie jednostki w Dataverse ma zostać utworzone, jeśli żadne unikatowe niesprzężone dopasowanie nie zostanie znalezione przy użyciu kryteriów dopasowania. Aby aktywować tę funkcjonalność, wybierz akcję Utwórz nowy, jeśli nie można odnaleźć dopasowania.
Widok wyników zlecenia sprzężenia
Aby wyświetlić wyniki zlecenia sprzężenia, należy otworzyć stronę Mapowania tabeli integracji, wybrać odpowiednie mapowanie, akcję Sprzężenie, a następnie akcję Dziennik zleceń sprzężenia z integracją.
Jeżeli sprzężenie rekordów się nie powiedzie, można wybrać wartość w kolumnie Niepowodzenie, aby otworzyć listę błędów opisujących zdarzenie.
Najczęstsze powody niepowodzenia sprzężenia to:
Nie zdefiniowano kryteriów sprzężenia
Należy uruchomić ponownie sprzężenie na podstawie dopasowań, ale zdefiniować kryteria sprzężenia.
Nie znaleziono dopasowań dla pól określonych w kryteriach dopasowania
Należy powtórzyć sprzężenie przy użyciu innych pól.
Znaleziono wiele dopasowań dla kilku rekordów na podstawie pól określonych w kryteriach dopasowania
Należy powtórzyć sprzężenie przy użyciu innych pól.
Znaleziono dopasowanie, ale rekord został już sprzężony z innym rekordem w Business Central
Powtórz sprzężenie przy użyciu innych pól lub zbadaj przyczyny sprzężenia tej jednostki Dataverse z rekordem Business Central.
Porada
Pole Sprzężone z Dataverse zapewnia podgląd postępu sprzężenia, pokazując, czy rekord został sprzężony z jednostką Dataverse. Można korzystać z pola Sprzężone z Dataverse do filtrowania listy synchronizowanych rekordów.
Uaktualnienie połączeń z Business Central Online, aby korzystać z uwierzytelniania z wykorzystaniem certyfikatów
Uwaga
Poniższy artykuł odnosi się tylko do dzierżawców Business Central online, którzy są hostowani przez Microsoft. Nie dotyczy ani dzierżawców online hostowanych przez niezależnych dostawców oprogramowania ani instalacji lokalnych.
W kwietniu 2022 Dataverse przestanie korzystać z uwierzytelniania Office365 (nazwa użytkownika/hasło). Dodatkowe informacje zamieszczono w artykule Zakończenie obsługi typu uwierzytelniania Office 365. Dodatkowo, w marcu 2022 roku Business Central przestanie korzystać z tajnego klucza klienta na podstawie uwierzytelniania pomiędzy usługami dla dzierżawców online. Zaleca się korzystanie z uwierzytelniania pomiędzy usługami opartego o certyfikat dla połączeń z Dataverse. Dzierżawcy Business Central online, hostowani przez niezależnych dostawców oprogramowania i instalacje lokalne mogą nadal używać tajnych kluczy klienta w uwierzytelnianiu.
Aby zapobiec zakłóceniom integracji, należy uaktualnić połączenie, aby wykorzystywało uwierzytelnianie na podstawie certyfikatów. Mimo, że zmiana została zaplanowana na marzec 2022 roku, zaleca się uaktualnienie w najbliższym możliwym terminie. W poniższych krokach opisano, w jaki sposób uaktualnić metodę uwierzytelniania, aby korzystała z certyfikatów.
Uaktualnienie połączenia z Business Central online, aby korzystać z uwierzytelniania z wykorzystaniem certyfikatów
- W zależności od tego, czy aplikacja jest zintegrowana z Dynamics 365 Sales, wykonaj jedno z następujących działań:
- Jeśli tak, otwórz stronę Ustawienia połączenia Microsoft Dynamics 365.
- Jeśli nie, otwórz stronę Ustawienia połączenia Dataverse.
- Wybierz Połączenie, a następnie Korzystaj z uwierzytelniania certyfikatu, aby uaktualnić połączenie, które ma wykorzystywać uwierzytelnianie w oparciu o certyfikaty.
- Zaloguj się w Dataverse z poświadczeniami administratora. Logowanie powinno potrwać mniej niż minutę.
Uwaga
Należy powtórzyć te kroki dla każdego środowiska Business Central, uwzględniając środowiska produkcyjne oraz piaskownicy, oraz w każdej firmie, w której istnieje połączenie z Dataverse.
Łączenie wersji lokalnych
Aby połączyć wersję lokalną Business Central z Dataverse, należy określić niektóre informacje na stronie Ustawienia połączenia Dataverse.
Aby połączyć aplikację przy użyciu konta Microsoft Entra, należy ją najpierw zarejestrować w Microsoft Entra ID. Użytkownik będzie musiał wprowadzić identyfikator aplikacji, klucz tajny magazynu oraz adres URL przekierowania. Adres URL przekierowania został wstępnie wypełniony i powinien działać z większością instalacji. Używanie HTTPS wymaga skonfigurowanej instalacji. Dodatkowe informacje zamieszczono w artykule Konfiguracja SSL w celu zabezpieczenia połączenia klienta sieci Web Business Central. Jeżeli serwer jest konfigurowany w celu zmiany strony głównej, można zmienić adres URL. Tajny klucz klienta zostanie zapisany w bazie danych jako zaszyfrowany ciąg.
Aby zarejestrować aplikację w Microsoft Entra ID do połączenia z Business Central do Dataverse
Następujące kroki zakładają wykorzystanie Microsoft Entra ID do zarządzania tożsamościami i dostępem. Dodatkowe informacje na temat rejestracji aplikacji w Microsoft Entra ID zamieszczono w artykule Szybki start: Zarejestruj aplikację w platformie tożsamości Microsoft.
- W portalu Azure, w okienku nawigacji, w sekcji Zarządzaj, wybierz Uwierzytelnianie.
- W sekcji Adres URL przekierowania, dodaj adres URL przekierowania sugerowany na stronie Ustawienia połączenia Dataverse w Business Central.
- W sekcji Zarządzaj, wybierz Uprawnienia API.
- W sekcji Skonfigurowane uprawnienia, wybierz opcję Dodaj uprawnienia, a następnie dodaj delegowane uprawnienia do karty API Microsoft w następujący sposób:
- Dla Business Central, dodaj uprawnienia Financials.ReadWrite.All.
- Dla Dynamics CRM, dodaj uprawnienia user_impersonation.
Uwaga
Nazwa API Dynamics CRM może ulec zmianie.
W sekcji Zarządzaj, wybierz Certyfikaty i tajne klucze, a następnie utwórz, dla twojej aplikacji, nowy tajny zapis. Tajny zapis zostanie wykorzystany w Business Central, w polu Tajny klucz klienta na stronie Ustawienia połączenia Dataverse, lub zostanie zapisany w bezpiecznym magazynie i przekazany subskrybentowi zdarzeń w sposób opisany wcześniej w tym artykule.
Wybierz Przegląd, a następnie znajdź wartość Identyfikator aplikacji (klient). Jest to identyfikator klienta aplikacji. Należy wprowadzić go na stronie Ustawienia połączenia Dataverse w polu Identyfikator klienta, lub zachować go w bezpiecznym magazynie i przekazać subskrybentowi zdarzeń.
W Business Central, na stronie Ustawienia połączenia Dataverse, w polu Adres URL środowiska, wprowadź adres URL twojego środowiska Dataverse.
Aby włączyć połączenie z Dataverse, uruchom przełącznik Włączone.
Zaloguj się w Azure Active Directory używając konta administratora (konto musi posiadać prawidłową licencję Dataverse i mieć uprawnienia administratora w środowisku Dataverse). Po zalogowaniu aplikacja poprosi o pozwolenie na zalogowanie się w Dataverse w imieniu organizacji. Aby ukończyć konfigurację, należy udzielić pozwolenia.
Uwaga
Jeśli system nie poprosił o zalogowanie się do konta administratora, należy sprawdzić, czy wyskakujące okienka nie są blokowane. Aby przejść do strony logowania, należy zezwolić na wyskakujące okienka na stronie Microsoft.
Aby odłączyć się od Dataverse
- Wybierz ikonę , wprowadź Ustawienia połączenia Dataverse, a następnie wybierz powiązane łącze.
- Na stronie Ustawienia połączenia Dataverse, wyłącz przełącznik Włączone.