Dodatek Business Central do konfiguracji RapidStart CRM

Kroki na wysokim poziomie

1. Utwórz lub użyj istniejącego środowiska z włączonym Dataverse.
2. Zainstaluj RapidStart CRM z AppSource w środowisku z włączonym Dataverse.
3. Uzyskaj identyfikator systemowy firmy Business Central.
4. Skonfiguruj integrację z poziomu Business Central.
5. Zweryfikuj rolę użytkownika aplikacji integracyjnej Business Central
6. Skonfiguruj mapowanie rekordów
7. Połącz środowiska (opcjonalnie)
8. Zainstaluj dodatek Business Central dla RapidStart CRM z AppSource w środowisku z włączonym Dataverse.
9. Zakończ w aplikacji ustawień RapidStart

Przed rozpoczęciem

Potwierdź te wymagania przed rozpoczęciem konfiguracji dodatku Business Central:

• Business Central i Dataverse muszą znajdować się w tym samym dzierżawcy Microsoft Entra dla wirtualnych tabel Business Central.
• Podczas konfiguracji użyj administratora z wymaganymi uprawnieniami Business Central i dostępem administratora systemu Dataverse.
• Potwierdź, że RapidStart CRM jest zainstalowany w środowisku Dataverse, które planujesz połączyć.

Krok 3: Uzyskaj identyfikator firmy

Aby uzyskać identyfikator firmy, wyszukaj Firmy w Business Central. Wybierz docelową firmę i naciśnij Ctrl+Alt+F1, aby otworzyć Inspekcję strony. Skopiuj wyświetlony ID i zapisz go na później.

Krok 4: Skonfiguruj integrację z poziomu Business Central

Zaloguj się do środowiska Business Central, które chcesz połączyć.

Zwróć uwagę na nazwę środowiska Business Central w pasku adresu. URL może również pokazywać nazwę wyświetlaną firmy, ale już uchwyciłeś identyfikator systemowy firmy GUID w poprzednim kroku.

Skopiuj nazwę środowiska Business Central do tych samych notatek, w których zapisałeś identyfikator systemowy firmy GUID.

1. Kliknij na zębatkę
2. Wybierz “Ustawienia wspomagane”

Przewiń do sekcji “Połącz z innymi systemami” i kliknij “Skonfiguruj połączenie z Dataverse”.

1. Wybierz, aby włączyć synchronizację danych
2. Wybierz, aby włączyć wirtualne tabele i zdarzenia
3. Kliknij “Dalej”

Zaakceptuj warunki i kliknij “Dalej”

Zaakceptuj połączenie z Dataverse “Zawsze zezwalaj”, i kliknij OK

Wybierz docelowe środowisko z włączonym Dataverse, i kliknij “Ok”

Potwierdź, że środowisko jest poprawne, a następnie kliknij link, aby zalogować się do środowiska Dataverse. Po zalogowaniu kliknij “Dalej”

Wybierz zalecaną własność zespołu, przełącz na Zakończ bez synchronizacji (zrobimy to później) i kliknij “Dalej”

1. Kliknij link, aby zainstalować aplikację Business Central Virtual Table
2. Kliknij “Dalej” (Otworzy się nowa karta do AppSource)

Kliknij przycisk “Pobierz teraz” (Ten dodatek jest darmowy), a następna strona się otworzy:

1. Wybierz docelowe środowisko (gdzie zainstalowałeś RapidStart CRM).
2. Zgódź się na warunki.
3. Kliknij “Zainstaluj”.

Zobaczysz, że rozwiązanie jest “Instalowane”. Może to potrwać kilka minut. Od czasu do czasu klikaj “odśwież”, aż zobaczysz, że jest “Zainstalowane”, a następnie wróć do karty przeglądarki Business Central, aby kontynuować.

Kliknij “Odśwież”

Zobaczysz, że aplikacja Virtual Tables została pomyślnie zainstalowana. Kliknij “Zakończ”

Po kilku minutach pojawi się ta strona. Wybierz kartę Virtual Tables, a następnie “Dostępne wirtualne tabele”

1. Zacznij od wybrania linii “element”
2. Kliknij “Włącz” (To utworzy wirtualną tabelę w Dataverse dla elementów)
3. Poczekaj, aż zobaczysz zaznaczone pole “Widoczne”. Może być konieczne kilkukrotne odświeżenie.

Powtórz te kroki dla: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment i salesShipmentLine. To zajmie kilka minut dla każdego z nich, aby włączyć.

Zmień sortowanie na Widoczne/malejąco i potwierdź, że widzisz wszystkie te tabele. Nie dodawaj więcej wirtualnych tabel w tym momencie. Możesz zostawić ekran tak jak jest (wrócimy do niego) i otworzyć nową kartę.

Krok 5: Zweryfikuj użytkownika aplikacji integracyjnej Business Central

Jeśli uprawnienia synchronizacji Business Central-Dataverse wydają się uszkodzone, otwórz Ustawienia połączenia z Dataverse w Business Central i użyj Ponownie wdroż rozwiązanie integracyjne. To przywraca rozwiązanie integracyjne Microsoftu i wdraża rolę bezpieczeństwa integracji Business Central.

Kontynuuj tylko po pomyślnym teście połączenia i gdy użytkownik aplikacji integracyjnej Business Central ma rolę Business Central Dataverse Integration Microsoftu.

Krok 6: Skonfiguruj mapowanie i łączenie rekordów

Mapowania referencyjne do skonfigurowania przed KLIENTEM

• WALUTA: Waluta Business Central → Waluta transakcji Dataverse. Kierunek musi być Business Central do Dataverse. Potwierdź te włączone mapowania pól: Kod → Kod waluty, Symbol → Symbol waluty i Opis → Nazwa waluty.
• Potwierdź, że mapowanie KLIENTA zawiera Kod waluty → Waluta. Synchronizuj waluty przed klientami. Waluta bazowa Dataverse i lokalna waluta Business Central muszą się zgadzać, a wymagane kursy wymiany muszą istnieć.
• Warunki płatności: synchronizuj z Warunkami płatności konta przed testowaniem klientów.
• Metoda wysyłki: synchronizuj z Warunkami frachtu konta przed testowaniem klientów.
• Agent wysyłkowy: synchronizuj z Metodą wysyłki konta przed testowaniem klientów.

Polityka tworzenia klientów

Ustaw KLIENTA na Dwukierunkowy, jeśli konta/firmy mogą być tworzone po obu stronach. Następnie wybierz politykę Synchronizuj tylko powiązane rekordy jako decyzję o wdrożeniu klienta:

Automatyczne tworzenie i łączenie klientów

1. Jeśli klient wybiera natywne automatyczne tworzenie, ustaw CUSTOMER na Bidirectional i Sync. Only Coupled Records na Wyłączone. Utrzymuj Sync New Account to BC wyłączone.
2. Pozostaw Disable Event-driven Synch. Job Rescheduling nie zaznaczone.
3. Potwierdź, że filtr tabeli integracyjnej CUSTOMER zawiera wybrany Company System ID. Dołącz 00000000-0000-0000-0000-000000000000 tylko wtedy, gdy celowo obsługiwane są starsze lub nieprzypisane wiersze Dataverse.
4. Potwierdź, że istnieje praca synchronizacji integracyjnej CUSTOMER i jej interwał spełnia potrzeby klienta. Status On Hold with Inactivity Timeout jest oczekiwanym między uruchomieniami; interwał 30 minut nie jest realizowany w czasie rzeczywistym.
5. Przed szeroką synchronizacją ręcznie połącz rekordy, które już istnieją po obu stronach, lub dokładnie przejrzyj kryteria i wyniki łączenia opartego na dopasowaniu. Automatyczne tworzenie nie identyfikuje bezpiecznie każdej istniejącej pary.

Łączenie używa integracji GUID, nie numeru klienta Business Central. Numer jest przydatny do wyświetlania i wyszukiwania; aby pokazać go w Dataverse, zweryfikuj mapowanie pola CUSTOMER z Business Central Nr. do Dataverse Nr konta..

Walidacja wartości opcji

Identyfikatory wartości enum Business Central używane dla Warunków płatności, Metody wysyłki i Agenta wysyłkowego muszą odpowiadać odpowiednim identyfikatorom opcji Dataverse. Sam tekst wyświetlany lub etykieta kodu nie wystarczą. Pełna synchronizacja nie naprawia niezgodności identyfikatorów, gdy Business Central zawiera niestandardowe wartości enum, które nie istnieją w Dataverse.

1. Uruchom Synchronizuj zmodyfikowane rekordy dla WARUNKÓW PŁATNOŚCI, METODY WYSYŁKI i AGENTA WYSYŁKOWEGO.
2. Sprawdź Mapowanie opcji Dataverse i dziennik błędów synchronizacji przed testowaniem KLIENTA.
3. Jeśli identyfikatory nie są zgodne, użyj bezpiecznego domyślnego na mapowaniach pól KLIENTA: Kod warunków płatności → Warunki płatności = FromIntegrationTable; Kod metody wysyłki → Adres 1: Warunki frachtu = FromIntegrationTable; Kod agenta wysyłkowego → Adres 1: Metoda wysyłki = FromIntegrationTable.
4. Zmień te trzy pola na Dwukierunkowy tylko po dodaniu przez dewelopera pasujących identyfikatorów opcji po obu stronach.
5. Nie wymyślaj ani nie zmieniaj numeracji identyfikatorów opcji podczas konfiguracji. Niestandardowe wartości Dataverse i rozszerzenia enum Business Central muszą używać dokładnie tych samych identyfikatorów.

Dla tych mapowań pól CUSTOMER, FromIntegrationTable oznacza Dataverse → Business Central tylko. To utrzymuje dwukierunkowe tworzenie konta/klienta, jednocześnie zapobiegając sytuacji, w której nieodpowiadające identyfikatory opcji Business Central blokują tworzenie wartości Business Central → Dataverse.

Wróć do karty Business Central w przeglądarce, którą zostawiliśmy otwartą.

1. Kliknij kartę “Integracja”
2. następnie “Mapowania tabel integracyjnych”

Decyzja klienta: zachowaj SPRZEDAWCY, jeśli klient chce standardowej synchronizacji użytkownika Dataverse do sprzedawcy Business Central Microsoftu. Usuń lub wyłącz to mapowanie tylko wtedy, gdy ta standardowa synchronizacja nie jest celowo używana.

1. Wybierz KONTAKT
2. Wybierz Powiązanie
3. Następnie kliknij “Powiązanie oparte na dopasowaniu”.
4. Dopasuj powyższe i kliknij OK

1. Wybierz WALUTA
2. Wybierz Powiązanie
3. Następnie kliknij “Powiązanie oparte na dopasowaniu”.
4. Dopasuj powyższe i kliknij OK

Dla CUSTOMER, wybierz Mapowanie/Pola, potem Edytuj listę. Włącz mapowanie z Business Central Nr. do Dataverse Nr Konta. jeśli numer klienta powinien pojawić się na koncie Dataverse. Nie zastępuje to jednak połączenia integracyjnego-GUID.

Nadal dla KLIENTA, wybierz Powiązanie/Powiązanie oparte na dopasowaniu. Dopasuj używając pól identyfikatora klienta/konta pokazanych na zrzucie ekranu i potwierdź, że pola dopasowania jednoznacznie identyfikują tego samego klienta po obu stronach.

Dla WARUNKÓW PŁATNOŚCI, wybierz Powiązanie/Powiązanie oparte na dopasowaniu. Dopasuj rekordy warunków płatności Business Central do odpowiadających wartości opcji warunków płatności Dataverse według skonfigurowanych identyfikatorów.

Dla METODY WYSYŁKI, wybierz Powiązanie/Powiązanie oparte na dopasowaniu. Dopasuj metody wysyłki Business Central do odpowiadających wartości opcji warunków frachtu Dataverse według skonfigurowanych identyfikatorów.

Dla AGENTA WYSYŁKOWEGO, wybierz Powiązanie/Powiązanie oparte na dopasowaniu. Dopasuj agentów wysyłkowych Business Central do odpowiadających wartości opcji metody wysyłki Dataverse według skonfigurowanych identyfikatorów.

Dla DOSTAWCY wybierz Mapowanie/Pola
1. Wybierz “Edytuj listę”
2. i “włącz” numer konta.

Nadal dla DOSTAWCY, wybierz Powiązanie/Powiązanie oparte na dopasowaniu. Dopasuj używając pól identyfikatora dostawcy/konta pokazanych na zrzucie ekranu i potwierdź, że pola dopasowania jednoznacznie identyfikują tego samego dostawcę po obu stronach.

Krok 7: Połącz środowiska (opcjonalnie)

Aby zapobiec przypadkowemu usunięciu środowisk, możesz je połączyć. Zacznij ponownie w Business Central.

1. Wybierz ikonę zębatki
2. Następnie wybierz Centrum administracyjne

Wybierz link do docelowego środowiska

Kliknij “Połącz” i wybierz swoje środowisko Dataverse

Krok 8: Zainstaluj dodatek Business Central dla RapidStart CRM z AppSource

Kliknij ten link, aby otworzyć AppSource Microsoftu i potwierdzić, że jesteś zalogowany na swoje konto biznesowe.

Wybierz “Pobierz teraz”, aby rozpocząć instalację.

1. Wybierz środowisko, w którym zainstalowałeś rozwiązanie Virtual Tables.
2. Zgódź się na warunki.
3. Kliknij Zainstaluj. Zauważ, że instalacja może potrwać kilka minut.

Zobaczysz, że rozwiązanie jest “Instalowane”. Może to potrwać kilka minut. Od czasu do czasu klikaj “odśwież”, aż zobaczysz, że jest “Zainstalowane”.

Krok 9: Zakończ w aplikacji ustawień RapidStart

Przejdź do RapidStart CRM i wybierz aplikację ustawień RapidStart.

Możesz otworzyć aplikację ustawień RapidStart z selektora aplikacji w RapidStart CRM, lub z portalu twórcy:
1. Wybierz Aplikacje w pasku bocznym.
2. Kliknij ikonę Uruchom dla aplikacji ustawień RapidStart.

1. Potwierdź, że jesteś w aplikacji ustawień RapidStart.
2. Wybierz “Aplikacje i dodatki” w pasku bocznym.
3. Kliknij “Skonfiguruj” dla dodatku Business Central.

Najpierw otwórz Connections. AppSource nie wyświetla monitów mapowania połączeń używanych podczas ręcznego importu rozwiązania. Kreator zgłasza stan połączenia, ale nie tworzy połączeń ani nie wiąże referencji połączeń.

1. W Connections, wybierz Configure dla referencji połączenia Microsoft Dataverse. Otwiera to Power Apps.
2. Wybierz to samo środowisko Dataverse, a następnie otwórz Solutions → RapidStart BC Addon → Connection references. Przydziel prawidłowe połączenie do referencji Microsoft Dataverse i zapisz.
3. Powtórz Configure dla referencji połączenia Dynamics 365 Business Central. W Power Apps przypisz prawidłową Business Central do tej referencji i zapisz.
4. Wróć do kreatora RapidStart Settings i wybierz Refresh. Zweryfikuj, czy obie referencje są połączone z aktywnymi połączeniami.
5. Wciąż w Connections, zapisz BC Environment jako nazwę środowiska Business Central oraz BC Company System ID jako Company System ID GUID zarejestrowany w kroku 3, a nie edytowalną nazwę firmy.
6. Gdy wymagane połączenia i ustawienia są gotowe, otwórz Automations i włącz zalecane przepływy. Pozostaw Sync New Account to BC i Sync New Contact to BC wyłączone, chyba że klient wybrał te ścieżki tworzenia. Jeśli natywna synchronizacja CUSTOMER jest właścicielem tworzenia klienta, pozostaw Sync New Account to BC wyłączone.

Zweryfikuj przed wdrożeniem

Użyj małego, kontrolowanego testu przed szeroką synchronizacją. Testy tworzenia poniżej mają zastosowanie, gdy wybrano natywne automatyczne tworzenie. Jeśli Sync. Only Coupled Records jest włączone, najpierw połącz rekordy testowe i zweryfikuj aktualizacje zamiast oczekiwać automatycznego tworzenia.

1. Potwierdź docelowe środowisko Dataverse, środowisko Business Central oraz Company System ID; przetestuj połączenie Dataverse od Business Central.
2. Potwierdź właściciela tworzenia. Dla natywnego automatycznego tworzenia, wyłącz Sync New Account to BC przed testowaniem.
3. Skonfiguruj i zsynchronizuj CURRENCY, PAYMENT TERMS, SHIPMENT METHOD i SHIPPING AGENT. Sprawdź Dataverse Option Mapping i błędy synchronizacji. Jeśli identyfikatory opcji nie są zgodne, użyj FromIntegrationTable dla trzech opisanych w kroku 6 mapowań pól opcji CUSTOMER.
4. Zweryfikuj, że CUSTOMER jest Bidirectional i potwierdź wybraną politykę Sync. Only Coupled Records. Dla automatycznego tworzenia ustaw to na Wyłączone i pozostaw Disable Event-driven Synch. Job Rescheduling niezaznaczone.
5. Przejrzyj filtry firmy CUSTOMER, potwierdź istnienie jej wpisu w kolejce zadań oraz zanotuj interwał synchronizacji. Ręcznie połącz znane istniejące pary; przejrzyj wyniki łączenia opartego na dopasowaniu przed ich zaakceptowaniem.
6. Uruchom Synchronize Modified Records, a nie pełną synchronizację, dla pierwszego kontrolowanego testu. Przejrzyj Integration Synchronization Jobs i rozwiąż problemy przed rozszerzeniem wdrożenia.
7. Utwórz unikalnie nazwane konto Dataverse, które spełnia filtry CUSTOMER, bez numeru klienta Business Central. Uruchom lub poczekaj na synchronizację. Potwierdź, że został utworzony klient Business Central z przypisanym numerem klienta oraz Coupled to Dataverse = Yes.
8. Zmień jedno mapowane pole na koncie Dataverse; uruchom lub oczekuj następnej synchronizacji i zweryfikuj aktualizacje powiązanego klienta Business Central.
9. Utwórz unikalnie nazwane klienta Business Central, który spełnia filtry. Potwierdź, że utworzono powiązane konto Dataverse; zmień jedno mapowane pole w Business Central i zweryfikuj aktualizację Dataverse.
10. Przetestuj klienta z walutą niebazową. Potwierdź, że mapowanie walut i kursy wymiany są prawidłowe.
11. Przetestuj tworzenie oferty tylko po połączeniu konta z ważnym klientem Business Central.
12. Uruchom pełną synchronizację tylko po przejrzeniu filtrów, danych referencyjnych, mapowania opcji, istniejących par oraz dzienników błędów.

Rozwiązywanie problemów

Brakujące identyfikatory połączeń

Napraw referencje połączeń w Power Apps: wybierz to samo środowisko Dataverse, a następnie Solutions → RapidStart BC Addon → Connection references. Przydziel i zapisz prawidłowe połączenia Microsoft Dataverse i Dynamics 365 Business Central. Wróć do kreatora RapidStart Settings i wybierz Refresh, a następnie włącz ponownie wymagany przepływ pod Automations. Kreator nie naprawia powiązań połączeń. Sama rekonstrukcja połączenia nie wystarczy, jeśli jego referencja nadal wskazuje na stare połączenie.

Błędy mapowania walut

Błąd: Table CRM Transactioncurrency must be mapped to table Currency to transfer value between fields TransactionCurrencyId and Currency Code.

Mapowanie CUSTOMER odnosi się do Waluty Dataverse, ale mapowanie CURRENCY lub jego mapowanie pola Kodu → Kodu Waluty jest brakujące, wyłączone, lub nie zsynchronizował odwoływanej waluty.

1. Przywróć lub utwórz mapowanie CURRENCY i ustaw jego kierunek na Business Central do Dataverse.
2. Włącz Kod → Kod Waluty i zsynchronizuj waluty.
3. Potwierdź, że waluta klienta istnieje w Dataverse, następnie ponów synchronizację CUSTOMER.

Niezgodności opcji

Przykład: The value 100000003 of 'paymenttermscode' on record of type 'account' is outside the valid range. Accepted Values: 1,2,3,4.

Business Central wysłał niestandardowy ID enuma Warunków Płatności, który nie jest obecny w wyborze Warunków Płatności Konta Dataverse.

1. Porównaj Dataverse Option Mapping z prawidłowymi ID wyborów Dataverse.
2. Jeśli opcja musi zostać zsynchronizowana w obie strony, poproś programistę o dodanie wartości wyborów Dataverse i wartości rozszerzenia enum Business Central z identycznymi numerycznymi ID. Nie wymyślaj ani nie zmieniaj numeracji ID podczas konfiguracji.
3. W przeciwnym razie, ustaw mapowanie pola Kod Warunków Płatności CUSTOMER na FromIntegrationTable. Stosuj tę samą kontrolę do Metody Wysyłki i Agenta Wysyłki.
4. Ponownie wypróbuj synchronizację jednego klienta i potwierdź, że akcja Business Central Konto otwiera powiązane konto Dataverse.

Powiązania wskazujące na usunięte rekordy

Jeśli rekord wydaje się powiązany, ale synchronizacja wskazuje na usunięty lub brakujący rekord, usuń nieaktualne powiązanie w Business Central i utwórz nowe powiązanie z poprawnym kontem lub kontaktem Dataverse przed ponownym uruchomieniem synchronizacji.

Referencje Microsoft

• Synchronizuj Business Central i Dataverse
• Zaplanuj zadania synchronizacji
• Ustaw połączenie Dataverse
• Obsługuj brakujące wartości opcji Dataverse