Rozwiązywanie problemów z synchronizacją na żywo

Artykuł
03/08/2023

Ten artykuł zawiera informacje dotyczące rozwiązywania problemów dotyczących integracji podwójnego zapisu między aplikacjami finansowymi i operacyjnymi oraz usługą Microsoft Dataverse. Ten temat zawiera informacje, które mogą pomóc w rozwiązaniu problemów związanych z synchronizacją na żywo.

Ważne

Niektóre problemy opisane w tym artykule mogą wymagać roli administratora systemu lub poświadczeń administratora klienta usługi Azure Active Directory (Azure AD). W każdej sekcji wyjaśniono, czy określona rola lub określone poświadczenia są wymagane.

Synchronizacja na żywo pokazuje błąd podczas tworzenia wiersza

Może pojawić się następujący komunikat o błędzie podczas tworzenia wiersza w aplikacjach finansowych i operacyjnych:

[{\"error\":{\"code\":\"0x80072560\",\"message\":\"The user is not a member of the organization.\"}}], Serwer zdalny zwrócił błąd: (403) zabroniony."}}".

Aby rozwiązać ten problem, należy wykonać kroki opisane w Wymagania systemowe i wymagania wstępne. Aby wykonać te kroki, użytkownicy aplikacji podwójnego odpisu, którzy utworzyli w Dataverse, muszą mieć rolę administratora systemu. Domyślny zespół będący właścicielem musi mieć również rolę Administratora systemu.

Synchronizacja na żywo pokazuje błąd podczas próby zapisania danych tabeli

Wymagana rola w celu rozwiązania problemu: administrator systemu

Może pojawić się następujący komunikat o błędzie podczas próby zapisania danych tabeli w aplikacjach finansowych i operacyjnych:

Nie można zapisać zmian w bazie danych. Jednostka pracy nie może wykonać transakcji. Nie można zapisać danych w jednostce uoms. Zapis w jednostce UnitOfMeasureEntity nie powiódł się. Komunikat o błędzie nie może być zsynchronizowany z jednostkami jednostki.

Aby rozwiązać ten problem, należy upewnić się, że istnieją dane referencyjne wymagań wstępnych w aplikacjach finansowych i operacyjnych i Dataverse. Jeśli na przykład rekord klienta należy do konkretnej grupy klientów, należy upewnić się, że rekord grupy klientów istnieje w usłudze Dataverse.

Jeśli istnieją dane w obu miejscach i potwierdzono, że ten błąd nie jest związany z danymi, wykonaj następujące kroki.

Otwórz encję DualWriteProjectConfigurationEntity przy użyciu dodatku programu Excel. Aby użyć tego dodatku, włącz tryb projektowania w dodatku programu Excel aplikacji finansowych i operacyjnych i dodaj do arkusza encję DualWriteProjectConfigurationEntity. Więcej informacji można znaleźć w temacie Wyświetlanie i aktualizowanie danych jednostki przy użyciu programu Excel.
Wybierz i usuń rekordy, które mają problemy w mapie i projekcie podwójnego zapisu. Dla każdego mapowania podwójnego zapisu będą dostępne dwa rekordy.
Opublikuj zmiany przy użyciu dodatku programu Excel. Ten krok jest ważny, ponieważ powoduje usunięcie rekordów z encji i tabel źródłowych.

Obsługa błędów uprawnień do odczytu lub odczytu podczas tworzenia danych w aplikacjach finansowych i operacyjnych

Może pojawić się komunikat o błędzie „Nieprawidłowe żądanie” podczas tworzenia danych w aplikacjach finansowych i operacyjnych.

Przykład komunikatu o błędzie złego żądania.

Aby rozwiązać ten problem, należy włączyć brakujące uprawnienie, przypisując poprawną rolę zabezpieczeń zespołowi zamapowanej jednostki biznesowej usługi Dynamics 365 Customer Service lub Dynamics 365 Sales.

W aplikacjach finansowych i operacyjnych znajdź jednostkę biznesową, która jest zamapowana w zestawie połączenia integracji danych.
W aplikacji angażującej klienta zaloguj się do środowiska, przejdź do pozycji Ustawienia > Zabezpieczenia i znajdź zespół zamapowanej jednostki biznesowej.
Otwórz stronę zespołu do edycji, a następnie wybierz pozycję Zarządzaj rolami.
W oknie dialogowym Zarządzanie rolami zespołu przypisz rolę, która ma uprawnienie do odczytu/zapisu dla odpowiednich tabel, a następnie wybierz przycisk OK.

Poprawianie problemów z synchronizacją w środowisku, w którym jest ostatnio zmienione środowisko Dataverse

Wymagana rola w celu rozwiązania problemu: administrator systemu

Może pojawić się następujący komunikat o błędzie podczas tworzenia danych w aplikacjach finansowych i operacyjnych:

{„EntityName”: „CustCustomerV3Entity”, „executionStatus”: 2, „fieldResponses”:, „recordResponses”:{„ErrorMessage”: „nie można wygenerować ładunku dla jednostki CustCustomerV3Entity”, „logDateTime”: „2019-08-27T 18:51:52.5843124Z”, „verboseError”: „Tworzenie ładunku nie powiodło się z powodu błędu nieprawidłowy identyfikator URI: identyfikator URI jest pusty”}, „isErrorCountUpdated”: prawda}

Oto jak wygląda komunikat o błędzie w aplikacji angażującej klienta:

Wystąpił nieoczekiwany błąd w kodzie ISV. (Błąd = ClientError) Nieoczekiwany wyjątek od wtyczki (Execute): Microsoft.Dynamics.Integrator.DualWriteRuntime.Plugins.PostCommitPlugin: System.Exception: nie można przetworzyć konta jednostki — (Próba połączenia nie powiodła się, ponieważ połączona strona nie odpowiedziała prawidłowo po upływie określonego czasu lub ustanowienie połączenia nie powiodło się, ponieważ połączony host nie odpowiedział.

Ten błąd występuje, gdy środowisko Dataverse jest niepoprawnie resetowane podczas próby utworzenia danych w aplikacjach finansowych i operacyjnych.

Ważne

Jeśli środowiska zostały ponownie połączone, musisz zatrzymać wszystkie mapy encji przed kontynuowaniem kroków ograniczenia ryzyka.

Aby rozwiązać ten problem, musisz wykonać kroki w usłudze Dataverse i w aplikacjach finansowych i operacyjnych.

W aplikacjach finansowych i operacyjnych wykonaj następujące kroki:
1. Otwórz encję DualWriteProjectConfigurationEntity przy użyciu dodatku programu Excel. Aby użyć tego dodatku, włącz tryb projektowania w dodatku programu Excel aplikacji finansowych i operacyjnych i dodaj do arkusza encję DualWriteProjectConfigurationEntity. Więcej informacji można znaleźć w temacie Wyświetlanie i aktualizowanie danych jednostki przy użyciu programu Excel.
2. Wybierz i usuń rekordy, które mają problemy w mapie i projekcie podwójnego zapisu. Dla każdego mapowania podwójnego zapisu będą dostępne dwa rekordy.
3. Opublikuj zmiany przy użyciu dodatku programu Excel. Ten krok jest ważny, ponieważ powoduje usunięcie rekordów z encji i tabel źródłowych.
4. Aby zapobiec błędom po ponownym połączeniu środowisk aplikacji finansowych i operacyjnych lub Dataverse, należy upewnić się, że nie pozostają żadne konfiguracje podwójnego zapisu.
W usłudze Dataverse wykonaj następujące kroki:
1. Zaloguj się do środowiska usługi Dataverse (na przykład https://*****.crm.dynamics.com/).
2. Przejdź do pozycji Ustawienia zaawansowane>Wyszukiwanie zaawansowane.
3. Wybierz pozycję Konfiguracja środowiska uruchomieniowego podwójnego zapisu.
4. Zaznacz kolumnę, którą chcesz wyświetlić.
5. Wybierz opcję Wyniki, aby wyświetlić konfiguracje.
6. Usuń wszystkie wystąpienia.
W aplikacjach finansowych i operacyjnych wykonaj następujące kroki:
1. Otwórz encję DualWriteProjectConfigurationEntity przy użyciu dodatku programu Excel. Aby użyć tego dodatku, włącz tryb projektowania w dodatku programu Excel aplikacji finansowych i operacyjnych i dodaj do arkusza encję DualWriteProjectConfigurationEntity. Więcej informacji można znaleźć w temacie Wyświetlanie i aktualizowanie danych jednostki przy użyciu programu Excel.
2. Wybierz i usuń rekordy, które mają problemy w mapie i projekcie podwójnego zapisu. Dla każdego mapowania podwójnego zapisu będą dostępne dwa rekordy.
3. Opublikuj zmiany przy użyciu dodatku programu Excel. Ten krok jest ważny, ponieważ powoduje usunięcie rekordów z encji i tabel źródłowych.
4. Aby zapobiec błędom po ponownym połączeniu środowisk aplikacji finansowych i operacyjnych lub Dataverse, należy upewnić się, że nie pozostają żadne konfiguracje podwójnego zapisu.

Błąd synchronizacji na żywo po zakończeniu wykonywania pełnej kopii bazy danych

Po uruchomieniu pełnej kopii bazy danych z jednego systemu do drugiego i próbie uruchomienia operacji na bazie danych może zostać wyświetlony następujący komunikat o błędzie:

Organizacja SecureConfig (???) nie pasuje do rzeczywistej organizacji CRM (???).

Komunikat o błędzie jest wyświetlany z dodatku środowiska uruchomieniowego podwójnego zapisu, co zapewnia, że konfiguracja podwójnego zapisu ustawiona w jednym systemie nie może być używana w innym systemie.

Aby rozwiązać ten problem, po przywróceniu bazy danych usuń wszystkie rekordy z tabeli msdyn_dualwriteruntimeconfig. Aby uzyskać więcej informacji, zobacz temat Odłączanie i ponownie podłączanie środowiska podwójnego zapisu.

Problemy z synchronizacją na żywo spowodowane przez niepoprawną składnię filtra zapisu na mapach podwójnego zapisu

Nawet jeśli wyrażenie zapytania dla filtru map podwójnego zapisu ma poprawną składnię, może nie działać zgodnie z oczekiwaniami. Wyrażenie filtru znajduje się w encji, a nie w jednym źródle danych obiektu zapytania. W związku z tym wygenerowane zapytanie SQL nie zwraca oczekiwanych wyników.

Oto przykład.

Query entity = PROJECTENTITY
Query expression = (ParentProject == "")

Można spodziewać się odfiltrowania projektów bez elementu nadrzędnego. Jednak filtr nie działa, ponieważ jest tłumaczony na zapytanie przypominające poniższy przykład.

SELECT T1.RECID,T1.MODIFIEDDATETIME,T1.RECVERSION,T1.RECID,T1.DIMENSION,
T1.LOCATION,T1.PROJECTCONTROLLER,T1.PROJECTID,T1.PROJECTMANAGER,T1.REFERENCE,
T1.SALESMANAGER,T1.SCHEDULED,T1.RECVERSION#8,T1.RECVERSION#7,
T1.RECVERSION#6,T1.RECVERSION#5,T1.RECVERSION#4,T1.RECVERSION#3,
T1.RECVERSION#2,T1.RECID#8,T1.RECID#7,T1.RECID#6,T1.RECID#5,
T1.RECID#4,T1.RECID#3,T1.RECID#2,T1.PARTITION FROM PROJECTENTITY T1 
WHERE(((((((((((PARTITION=5637144576) AND (DATAAREAID=N'usmf')) AND 
((PARTITION#2=5637144576) OR (PARTITION#2 IS NULL))) AND 
((PARTITION#3=5637144576) OR (PARTITION#3 IS NULL))) AND 
((PARTITION#4=5637144576) OR (PARTITION#4 IS NULL))) AND 
((PARTITION#5=5637144576) OR (PARTITION#5 IS NULL))) AND 
((PARTITION#6=5637144576) OR (PARTITION#6 IS NULL))) AND 
((PARTITION#7=5637144576) OR (PARTITION#7 IS NULL))) AND 
((PARTITION#8=5637144576) OR (PARTITION#8 IS NULL))) AND 
((DATAAREAID#8=N'usmf') OR (DATAAREAID#8 IS NULL))) AND 
(PARENTPROJECT='')) 
ORDER BY T1.PROJECTID

W wyniku tego pole parentProject jest szacowane jako null. Jednak ciąg null nie jest taki sam jak ciąg pusty. Z powodu tej niezgodności filtr zapytania nie zwraca prawidłowych wyników.

Aby naprawić problem, należy wykonać następujące czynności.

Dodaj kolumnę obliczaną, która może zostać dodana do modelu rozszerzenia i która jest wspierana przez logikę konwertującą wartość null na pusty ciąg.
```
SysComputedColumn::if(SysComputedColumn::isNullExpression(ParentProject), SysComputedColumn::returnLiteral(""), fieldName);
```
Użyj filtru w nowej kolumnie obliczanej zamiast domyślnej kolumny.

Aby ocenić filtr w środowisku programowania, można użyć następującego kodu X++, aby zweryfikować wyniki. Uruchom ten kod jako program autonomiczny. Przed użyciem tych filtrów na mapach podwójnego zapisu można go używać do szacowania różnych rodzajów filtrów, które są odpowiednie dla encji. Zapytanie można uruchomić na bazie danych w celu oszacowania niezgodności.

var entityName = "PROJECTENTITY";
var filterExpression = '(ParentProject == "")';
Query query = new Query();
query.literals(NoYes::Yes); 
QueryBuildDataSource qbd = query.addDataSource(tablename2id(entityName));
qbd.addRange(fieldname2id(qbd.table(),identifierStr(RecVersion))).value(filterExpression);
qbd.addSelectionField(fieldname2id(qbd.table(),identifierStr(RecId)));
QueryRun qRun = new QueryRun(query);
// This provides the actual sql statement to execute
var actualSqlStatement = query.getSQLStatement();
while(qRun.next())
{
    var rec = qRun.get(tableName2Id(entityName));
}

Dane z aplikacji finansowych i operacyjnych nie są synchronizowane do Dataverse

Podczas synchronizacji na żywo może wystąpić problem, gdy tylko część danych jest synchronizowana z aplikacji finansowych i operacyjnych do usługi Dataverse lub dane w ogóle nie są synchronizowane.

Banknot

Ten problem należy rozwiązać podczas developmentu.

Przed rozpoczęciem rozwiązania problemu przejrzyj następujące wymagania wstępne:

Upewnij się, że niestandardowe zmiany zostały zapisane w zakresie jednej transakcji.
Zdarzenia biznesowe i struktura podwójnego zapisu nie obsługują operacji doinsert(), doUpdate() ani recordset() lub rekordów z oznaczonym elementem skipBusinessEvents(true). Jeśli kod znajduje się wewnątrz tych funkcji, podwójny zapis nie będzie wyzwalany.
Zdarzenia biznesowe muszą być zarejestrowane dla źródła danych, które jest mapowane. Niektóre źródła danych mogą używać sprzężenia zewnętrznego i mogą być oznaczone jako tylko do odczytu w aplikacjach finansowych i operacyjnych. Te źródła danych nie są śledzone.
Zmiany będą wyzwalane tylko wtedy, gdy modyfikacje są w mapowanych polach. Niezamapowane modyfikacje pól nie będą wyzwalać podwójnego zapisu.
Upewnij się, że oceny filtru zapewniają prawidłowy wynik.

Kroki rozwiązywania problemów

Przejrzyj mapowania pól na stronie administrowania podwójnym zapisem. Jeśli pole nie jest mapowane w aplikacjach finansowych i operacyjnych do usługi Dataverse, nie będzie śledzone. Na przykład na poniższej ilustracji pole Opis jest śledzone z usługi Dataverse, ale nie w aplikacjach finansowych i operacyjnych. Zmiany tego pola w aplikacjach finansowych i operacyjnych nie będą śledzone.
Określ, czy źródło danych jest śledzone w definicji zdarzeń biznesowych. Na przykład na poniższej ilustracji zmiany nie będą śledzone w polach tabeli DefaultDimensionDAVs i tabel źródłowych. Źródła danych, które korzystają z sprzężenia zewnętrznego i które są oznaczone jako tylko do odczytu, nie są śledzone.
Określ, czy zamapowane pola tabeli mają być wyświetlane w tabeli BUSINESSEVENTSDEFINITION, jak pokazano na poniższej ilustracji. Jeśli nie znajdziesz pola, którego szukasz w wyniku zapytania, nie zostanie ono wywołane przez podwójny zapis.

Przykładowy scenariusz

W aplikacjach finansowych i operacyjnych istnieje aktualizacja adres rekordu kontaktu, ale zmiana adresu nie jest synchronizowana z usługą Dataverse. Ten scenariusz występuje, ponieważ żaden rekord w tabeli BusinessEventsDefinition nie zawiera kombinacji tej tabeli i encji. W szczególności tabela LogisticsPostalAddress nie jest bezpośrednim źródłem danych dla encji smmContactpersonCDSV2Entity. Źródłem danych encji smmContactpersonCDSV2Entity jest encja smmContactPersonV2Entity, a z kolei źródłem danych encji smmContactPersonV2Entity jest encja LogisticsPostalAddressBaseEntity. Tabela LogisticsPostalAddress jest źródłem danych dla encji logisticsPostalAddressBaseEntity.

Podobna sytuacja może wystąpić w pewnych niestandardowych wzorcach, takich jak przypadki, w których tabela modyfikowana w aplikacjach finansowych i operacyjnych nie jest w oczywisty sposób połączona z zawierającą ją encją. Na przykład dane adresu podstawowego są obliczane w encji smmContactPersonCDSV2Entity. Struktura podwójnego zapisu próbuje ustalić, w jaki sposób zmiana w tabeli podstawowej jest mapowana z powrotem na encje. Zwykle to podejście jest wystarczające. Jednak w niektórych przypadkach połączenie jest tak złożone, że należy je dokładnie zdefiniować. Musisz się upewnić, że identyfikator powiązanej tabeli RecId jest bezpośrednio dostępny w encji. Następnie dodaj statyczną metodę w celu monitorowania tabeli pod kątem zmian.

Aby zapoznać się z przykładem, zapoznaj się z metodą smmContactPersonCDSV2Entity::getEntityDataSourceToFieldMapping(). Encje CustCustomerV3entity i VendVendorV2Entity zostały zmodyfikowane, aby obsłużyć tę sytuację.

Aby naprawić problem, należy wykonać następujące czynności.

Dodaj pole PrimaryPostalAddressRecId do encji smmContactPersonV2Entity. Oznacz je jako wewnętrzne.
Dodaj identyczne pole do encji smmContactPersonCDSV2Entity.

Dodaj następującą metodę do klasy smmContactPersonCDSV2Entity.

public static container getEntityDataSourceToFieldMapping(container mapping)
{
    mapping += [[tablestr(smmContactPersonCDSV2Entity), tablenum(LogisticsPostalAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryPostalAddressRecId)]];
    return mapping;
}

Zsynchronizuj bazę danych i skompiluj aplikację.
Zatrzymaj wszystkie mapy podwójnego zapisu utworzone w encji smmContactPersonCDSV2Entity.
Uruchom mapę. Powinna pojawić się nowa tabela (LogisticsPostalAddress w tym przykładzie), która była śledzona za pomocą kolumny RefTableName dla wiersza, w którym wartość refentityname jest równa smmContactPersonCDSV2Entity w tabeli BusinessEventsDefinition.

Błąd podczas tworzenia rekordu, w którym wiele rekordów jest wysyłanych z w aplikacjach finansowych i operacyjnych do usługi Dataverse w tej samej partii

W przypadku każdej transakcji w aplikacjach finansowych i operacyjnych tworzy dane w partii i wysyła je jako partię do usługi Dataverse. Jeśli w ramach tej samej transakcji utworzone zostaną dwa rekordy i odwołują się one do siebie, może zostać wyświetlony komunikat o błędzie przypominający następujący przykład w aplikacjach finansowych i operacyjnych:

Nie można zapisać danych w jednostce aaa_fundingsources. Nie można wyszukać ebecsfs_contracts z wartościami {PC00...}. Nie można wyszukać aaa_fundingsources z wartościami {PC00...}. Zapisuje błąd aaa_fundingsources. Komunikat o błędzie: serwer zdalny zwrócił błąd: (400) Błąd.

Aby rozwiązać ten problem, utwórz w aplikacjach finansowych i operacyjnych relacje encji, aby wskazać, że te dwie encje są ze sobą powiązane oraz że powiązane rekordy są obsługiwane w tej samej transakcji.

Włącz pełne rejestrowanie komunikatów o błędach

W aplikacjach finansowych i operacyjnych mogą wystąpić błędy związane ze środowiskiem usługi Dataverse. Komunikat o błędzie może nie zawierać pełnego tekstu wiadomości lub innych odpowiednich danych. Aby uzyskać więcej informacji, można włączyć pełne rejestrowanie, ustawiając flagę IsDebugMode dostępną w encji DualWriteProjectConfigurationEntity we wszystkich konfiguracjach projektów w aplikacjach finansowych i operacyjnych.

Otwórz encję DualWriteProjectConfigurationEntity przy użyciu dodatku programu Excel. Aby użyć tego dodatku, włącz tryb projektowania w dodatku programu Excel aplikacji finansowych i operacyjnych i dodaj do arkusza encję DualWriteProjectConfigurationEntity. Więcej informacji można znaleźć w temacie Wyświetlanie i aktualizowanie danych jednostki przy użyciu programu Excel.
Ustaw flagę IsDebugMode na Tak dla projektu.
Uruchom scenariusz.
Pełne dzienniki są dostępne w tabeli DualWriteErrorLog. Aby szukać danych za pomocą przeglądarki tabel, użyj następującego adresu URL: https://XXXaos.cloudax.dynamics.com/?mi=SysTableBrowser&tableName=DualWriteErrorLog.
Aby przechwycić więcej dzienników w trybie debugowania, zainstaluj aktualizację w KB 4595434 (Poprawka dla wartości pustych wypełnianych w trakcie synchronizacji podwójnego zapisu na żywo).

Błąd podczas dodawania adresu klienta lub kontaktu

Podczas próby dodania adresu klienta lub kontaktu w aplikacjach finansowych i operacyjnych lub usłudze Dataverse może pojawić się następujący komunikat o błędzie:

Nie można zapisać danych do elementu msdyn_partypostaladdresses. Zapis w DirPartyPostalAddressLocationCDSEntity nie powiódł się. Żądanie komunikatu o błędzie nie powiodło się. Kod stanu: BadRequest i kod błędu usługi CDS: 0x80040265 komunikat odpowiedzi: wystąpił błąd w dodatku plug-in. Rekord z wartościami atrybutów Identyfikator lokalizacji już istnieje. Klucz identyfikatora lokalizacji klucza jednostki wymaga, aby ten zestaw atrybutów zawierał unikatowe wartości. Wybierz unikatowe wartości i spróbuj ponownie.

Aby rozwiązać ten problem, zainstaluj pakiet aranżacji podwójnego zapisu w odpowiedniej wersji (2.2.2.60), tak aby klucze w tabeli Adres zostały zdefiniowane zgodnie z następującą tabelą.

Właściwość	Wartość
Nazwa wyświetlana	Klucz lokalizacji
Imię i nazwisko	msdyn_locationkey
Pola	msdyn_locationid, parentid
Stan	Aktywni
Zadanie systemowe	Pusty

Błąd podczas dodawania klienta do usługi Dataverse

Może pojawić się następujący komunikat o błędzie podczas próby dodania klienta w usłudze Dataverse:

„RecordError0”:„Zapis nie powiódł się dla encji Klienci (wersja 3) z nieznanym wyjątkiem — nie znaleziono rekordu jednostki dla typu strony „Organizacja”}.

Po utworzeniu klienta w usłudze Dataverse jest generowany nowy numer strony. Komunikat o błędzie jest wyświetlany, gdy rekord klienta oraz strona są synchronizowane z aplikacjami finansowymi i operacyjnymi, ale istnieje już rekord klienta o innym numerze strony.

Aby rozwiązać ten problem, znajdź klienta za pomocą wyszukiwania strony. Jeśli klient nie istnieje, utwórz nowy rekord klienta. Jeśli klient nie istnieje, użyj istniejącej strony, aby utworzyć nowy rekord klienta.

Błąd podczas tworzenia nowego klienta, dostawcy lub kontaktu w usłudze Dataverse

Podczas próby dodania nowego klienta, dostawcy lub kontaktu w usłudze Dataverse może pojawić się następujący komunikat o błędzie:

Nie można zaktualizować typu strony z „DirOrganization” na „DirPerson”. W zamian należy usunąć istniejącą stronę, a następnie wstawić ją z nowym typem.

W usłudze Dataverse istnieje sekwencja numerów tabeli msdyn_party. Podczas tworzenia konta w usłudze Dataverse jest tworzona nowa strona (na przykład Strona-001 typu Organizacja). Te dane są wysyłane do aplikacji finansowych i operacyjnych. Jeśli środowisko Dataverse zostanie zresetowane lub środowisko w aplikacjach finansowych i operacyjnych zostanie połączone z innym środowiskiem Dataverse, a następnie zostanie utworzony nowy rekord osoby kontaktowej w usłudze Dataverse, zostanie utworzona nowa wartość strony, która zaczyna się od Strona-001. Tym razem utworzony rekord strony to Strona-001 typu Osoba. Po zsynchronizowaniu tych danych w aplikacjach finansowych i operacyjnych będą wyświetlać poprzedni komunikat o błędzie, ponieważ rekord strony Strona-001 typu Organizacja już istnieje.

Aby rozwiązać ten problem, zmień automatyczną sekwencję numerów dla pola msdyn_partynumber tabeli msdyn_party w usłudze Dataverse na inną automatyczną sekwencję numerów.

Problem z wydajnością mapowań klientów lub osób kontaktowych

Można uzyskać niewielką poprawę wydajności synchronizacji na żywo dla klientów i kontaktów, dostosowując metodę getEntityDataSourceToFieldMapping (w encji CustCustomerV3Entity) i metodę getEntityDataSourceToFieldMapping (w encji smmContactPersonCDSV2Entity). Te dostosowania redukują liczbę rekordów w tabeli BusinessEventsDefinition. Ta redukcja liczby rekordów zmniejsza z kolei liczbę wywoływanych zdarzeń.

Metoda getEntityDataSourceToFieldMapping w encji CustCustomerV3Entity zapewnia, że aktualizacja adresu elektronicznego lub adresu pocztowego klienta wyzwala zdarzenia biznesowe, dzięki czemu zaktualizowane dane zostaną wysłane do usługi Dataverse. Jeśli nie używasz wszystkich pól i informacje nie są potrzebne w trybie podwójnego zapisu, skomentuj odpowiednie wiersze w metodzie. Każde śledzone pole i tabela dodane do tej metody dodają rekord w tabeli BusinessEventsDefinition dla kombinacji śledzonej tabeli i śledzonej encji.

public static container getEntityDataSourceToFieldMapping(container mapping)
{
    mapping += [
        [tablestr(DirPartyBaseEntity), tablenum(LogisticsPostalAddress), fieldstr(CustCustomerV3Entity, AddressRecordId)],
        [identifierstr(DirPartyBaseEntity), tablenum(LogisticsElectronicAddress), fieldstr(CustCustomerV3Entity, PrimaryContactURLRecordId)],
        [identifierstr(DirPartyBaseEntity1), tablenum(LogisticsElectronicAddress), fieldstr(CustCustomerV3Entity, PrimaryContactPhoneRecordId)],
        [identifierstr(DirPartyBaseEntity2), tablenum(LogisticsElectronicAddress), fieldstr(CustCustomerV3Entity, PrimaryContactEmailRecordId)],
        [identifierstr(DirPartyBaseEntity3), tablenum(LogisticsElectronicAddress), fieldstr(CustCustomerV3Entity, PrimaryContactFaxRecordId)],
        [identifierstr(DirPartyBaseEntity4), tablenum(DirPartyLocation), fieldstr(CustCustomerV3Entity, DirPartyLocationRecordId)],
        [identifierstr(DirPartyBaseEntity5), tablenum(LogisticsPostalAddress), fieldstr(CustCustomerV3Entity, InvoiceAddressRecordId)],
        [identifierstr(DirPartyBaseEntity6), tablenum(LogisticsPostalAddress), fieldstr(CustCustomerV3Entity, DeliveryAddressRecordId)],
        [identifierStr(DirPartyBaseEntity7), tablenum(DirPartyTable), fieldstr(CustCustomerV3Entity, PartyRecordId)]];
    return mapping;
}

Podbonie metoda getEntityDataSourceToFieldMapping w encji smmContactPersonCDSV2Entity zapewnia, że aktualizacja adresu elektronicznego lub adresu pocztowego wyzwala zdarzenia biznesowe, dzięki czemu zaktualizowane dane zostaną wysłane do usługi Dataverse. W tej metodzie można skomentować wiersze we wszystkich nieużywanych polach.

public static container getEntityDataSourceToFieldMapping(container mapping)
{
    mapping += [
        [tablestr(DirPartyBaseEntity), tablenum(LogisticsPostalAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryPostalAddressRecId)],
        [identifierStr(DirPartyBaseEntity), tablenum(DirPartyTable), fieldstr(smmContactPersonCDSV2Entity, PrimaryAddressLocation)],
        [identifierStr(DirPartyBaseEntity1), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactEmailRecordId)],
        [identifierStr(DirPartyBaseEntity2), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactFaxRecordId)],
        [identifierStr(DirPartyBaseEntity3), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactPhoneRecordId)],
        [identifierStr(DirPartyBaseEntity4), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactFacebookRecordId)],
        [identifierStr(DirPartyBaseEntity5), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactTwitterRecordId)],
        [identifierStr(DirPartyBaseEntity6), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactURLRecordId)],
        [identifierStr(DirPartyBaseEntity7), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactLinkedInRecordId)],
        [identifierStr(DirPartyBaseEntity8), tablenum(LogisticsElectronicAddress), fieldstr(smmContactPersonCDSV2Entity, PrimaryContactTelexRecordId)],
        [identifierStr(DirPartyBaseEntity9), tablenum(DirPartyTable), fieldstr(smmContactPersonCDSV2Entity, PartyRecordId)]];
    return mapping;
}

Po zaktualizowaniu metod wykonaj poniższe kroki.

Zsynchronizuj bazę danych i skompiluj aplikację.
Zatrzymaj wszystkie mapy podwójnego zapisu utworzone w encjacj smmContactPersonCDSV2Entity i CustCustomerV3Entity.
Uruchom mapy. W encjach smmContactPersonCDSV2Entity i CustCustomerV3Entity powinno być mniej rekordów, a tabela BusinessEventsDefinition i wydajność mogą się nieznacznie poprawić.

Udostępnij za pośrednictwem