Tworzenie lub edytowanie encji wirtualnej z danymi z zewnętrznego źródła

Ten temat dotyczy platformy Dynamics 365 Customer Engagement (on-premises). Aby zapoznać się z wersją tego tematu dotyczącą usługi Power Apps, zobacz: Tworzenie i edytowanie encji wirtualnych, które zawierają dane z zewnętrznych źródeł danych

Encja wirtualna to encja niestandardowa w usłudze Dynamics 365 Customer Engagement (on-premises), która posiada pola zawierające dane z zewnętrznego źródła danych. Encje wirtualne są widoczne w Twojej aplikacji dla użytkowników jako zwykłe rekordy encji, ale zawierają dane pochodzące z zewnętrznej bazy danych, takiej jak Azure SQL Database. Rekordy oparte na encjach wirtualnych są dostępne we wszystkich klientach, w tym w klientach niestandardowych opracowanych przy użyciu usług sieci Web Dynamics 365 Customer Engagement.

W przeszłości, aby zintegrować różne źródła danych należało utworzyć łącznik, aby przenieść dane lub opracować niestandardowy dodatek typu plug-in, po stronie klienta lub po stronie serwera. Jednak dzięki encjom wirtualnym można połączyć się bezpośrednio z zewnętrznym źródłem danych w czasie wykonywania tak, aby określone dane z zewnętrznego źródła danych były dostępne w środowisku, bez konieczności replikacji danych.

Encje wirtualne składają się z trzech podstawowych składników, dostawcy danych, rekordu źródło danych rekord oraz encja wirtualna. Dostawca danych składa się z dodatków typu plug-in i encji źródło danych. Źródło danych jest rekordem encji w Dynamics 365 Customer Engagement (on-premises), która obejmuje metadane, co reprezentuje schemat parametrów połączenia. Każda encja wirtualna odwołuje się do źródła danych definicji encji.

Dynamics 365 Customer Engagement (on-premises) zawiera dostawcę danych OData, którego można użyć do połączenia się z usługą sieci Web OData v4, która uzyskuje dostęp do danych zewnętrznych.

Alternatywnie deweloperzy mogą tworzyć własnych dostawców danych. Dostawcy danych zostali zainstalowani w środowisku jako rozwiązanie. Więcej informacji znajduje się w temacie Rozpoczęcie pracy z encjami wirtualnymi

Korzyści związane z encjami wirtualnymi

• Deweloperzy mogą zaimplementować wtyczki do odczytywania, usuwania lub aktualizacji danych zewnętrznych przy użyciu usług internetowych Dynamics 365 Customer Engagement i narzędzia do rejestracji wtyczek Customer Engagement.

• Konfiguratorzy systemu używają Dynamics 365 Customer Engagement (on-premises), aby skonfigurować rekord źródła danych i utworzyć encje wirtualne, które są używane do dostępu do danych zewnętrznych bez konieczności pisania kodu.

• Użytkownicy końcowi pracują nad rekordami utworzonymi przez encję wirtualną w celu wyświetlania danych w polach, siatkach, wynikach wyszukiwania oraz raportach i pulpitach nawigacyjnych opartych na języku Fetch XML.

Dodaj źródło danych do użycia dla encji wirtualnych

Deweloperzy tworzą niestandardowe dodatki plug-in do użycia jako dostawca danych dla encji wirtualnej. Można również użyć z zapewnionego dostawcy danych OData v4. Więcej informacji: Konfiguracja dostawcy danych OData v4, wymagania i sprawdzone metody postępowania

1. Przejdź do Ustawienia>Administracja>Źródła danych encji wirtualnych.

2. Na pasku narzędzi Akcje wybierz Nowa.

3. W oknie dialogowym Wybierz dostawcę danych wybierz jedno z poniższych źródeł danych, a następnie wybierz OK.

   • Niestandardowy dostawca danych. Jeśli zaimportowałeś dodatek plug-in dostawcy danych, dostawca danych pojawi się w tym miejscu. Więcej informacji znajduje się w temacie Rozpoczęcie pracy z encjami wirtualnymi

   • Dostawca danych OData v4. Dynamics 365 Customer Engagement (on-premises) zawiera dostawcę danych OData, którego można użyć z usługami sieci Web v4 OData. Więcej informacji: Konfiguracja dostawcy danych OData v4, wymagania i sprawdzone metody postępowania

Dodaj zabezpieczone pole do źródła danych

Pola dla Źródła danych można tworzyć w taki sam sposób, jak w przypadku wszystkich innych encji. W przypadku danych zaszyfrowanych lub poufnych włącz atrybut Tajne źródło danych na polu niestandardowym Źródła danych. Na przykład, aby zabezpieczyć pole zawierające ciąg połączenia bazy danych.

Uwaga

Atrybut tajne źródło danych jest dostępny tylko dla pól dodanych do formularza Źródło danych.

Tworzenie encji wirtualnej

Tworzysz encję wirtualną, podobną do innych encji, w Customer Engagement z dodatkiem kilku uzupełniających atrybutów opisanych w tym miejscu.

Uwaga

Mimo że możesz utworzyć encję wirtualną, wybierając Brak jako źródło danych w celu uzyskania danych, encja wirtualna wymaga źródła danych. Więcej informacji: Dodaj źródło danych do użycia dla encji wirtualnych

1. Przejdź do Ustawienia>Dostosowania>Dostosuj system.

2. W Eksploratorze rozwiązań utwórz nową encję. Aby to zrobić wybierz Encje w okienku nawigacji po lewej stronie, a następnie wybierz Nowa.

3. Na karcie OgólneDefinicja encji, wybierz Encja wirtualna, a następnie z listy rozwijanej Źródło danych wybierz źródło danych.

   

4. W Definicja encji wypełnij poniższe pola wymagane.

   • Nazwa zewnętrzna. Wprowadź nazwę tabeli w źródle danych zewnętrznych, do którego mapuje ta encja.

   • Nazwa kolekcji zewnętrznej. Wprowadź nazwę w liczbie mnogiej w tabeli w źródle danych zewnętrznych, do którego mapuje ta encja.

     Poniżej przedstawiono przykładową encję wirtualną o nazwie Film, która używa dostawcy danych Azure Cosmos DB, aby uzyskać dostęp do dokumentów plików.

   

   Ważne

   Szereg opcji, takich jak Zespoły mające dostęp, Kolejki i Szybkie tworzenie, nie jest dostępnych z encjami wirtualnymi. Więcej informacji: Zagadnienia dotyczące korzystania z encji wirtualnych

   W razie potrzeby, uzupełnij dodatkowe właściwości wymagane i opcjonalne, takie jak wyświetlanie i nazwy w liczbie mnogiej. Aby uzyskać więcej informacji na temat tych właściwości, zobacz Tworzenie i edytowanie encji.

5. Utwórz i dodaj jedno lub kilka pól dla encji wirtualnej. Oprócz standardowych właściwości pól wymaganych do tworzenia pola niestandardowego, te opcjonalne właściwości są dostępne dla każdego pola niestandardowego, które utworzysz dla encji wirtualnej.

   • Nazwa zewnętrzna. Jest to zazwyczaj unikatowa nazwa służąca do identyfikacji danych, które mają być wyświetlane w polu.

   Uwaga

   Jeśli typ pola, które tworzysz to OptionSet, dostępne są następujące dodatkowe pola.

   • Nazwa typu zewnętrznego. Ta właściwość jest mapowana na nazwę zewnętrzną zestawu wartości w usłudze zewnętrznej dla zestawu opcji. Zwykle to może to być klasy wartości enum lub nazwa ciągu. Nazwa typu zewnętrznego może być używana, gdy wymagana jest w pełni kwalifikowana nazwa. Na przykład, jako Nazwa typu z OData, gdzie parametry w zapytaniu wymagają w pełni kwalifikowanej nazwy, takiej jak [Nazwa typu].[Wartość].
   • Wartość zewnętrzna. Ta właściwość mapuje do odpowiadającej wartości w zewnętrznym źródle danych dla elementu zestaw opcji. Ta wartość wprowadzona jest używana w celu ustalenia, który element zestawu opcji należy wyświetlić w aplikacji.

   Uzupełnij dodatkowe właściwości stosownie do potrzeb. Aby uzyskać więcej informacji na temat tych właściwości, zobacz Tworzenie i edytowanie pól.

6. Wybierz Zapisz i zamknij na stronie właściwości Pole.

7. Na pasku narzędzi eksploratora rozwiązań wybierz Zapisz.

8. Na pasku narzędzi eksploratora rozwiązań wybierz Opublikuj.

9. Zamknij eksplorator rozwiązań.

Zagadnienia dotyczące korzystanie z encji wirtualnych

Encje wirtualnego wiążą się z poniższymi ograniczeniami.

• Wszystkie encje wirtualne są tylko do odczytu.

• Istniejących encji nie można przekonwertować na encje wirtualne.

• Domyślnie encje wirtualne zawierają tylko pole Nazwa i identyfikator. Żadne inne pola zarządzane systemowo, takie jak Stan lub Data utworzenia/Data modyfikacji nie są obsługiwane.

• Encje wirtualne nie obsługują niestandardowych pól z typami danych Waluta, Obraz lub Klient.  

• Encje wirtualne nie obsługują inspekcji.

• Nie można używać pól encji wirtualnych w zestawieniach i polach obliczanych.  

• Encja wirtualna nie może być typem działania encji.

• Wiele funkcji, które wpływają na wiersze tabeli encji nie może być włączanych z encjami wirtualnymi. Przykładami są kolejki, zarządzanie bazą wiedzy, SLA, wykrywanie duplikatów, śledzenie zmian, funkcja mobile offline, zabezpieczenia pola, Wyszukiwanie wg stopnia zgodności, Portale dla rozwiązań portali sieci Web Dynamics 365 Customer Engagement (on-premises) i relacje N:N pomiędzy encjami wirtualnymi.

• Encje wirtualne należą do organizacji i nie obsługują pojąć zabezpieczeń na poziomie wiersza Common Data Service for Apps. Zalecamy implementowanie własnego modelu zabezpieczeń dla zewnętrznego źródła danych.

• Zalecamy wskazanie jednego źródła danych, podczas korzystania z encji wirtualnych w Szukaniu zaawansowanym. Na przykład nie jest obsługiwane tworzenie funkcji Szukanie zaawansowane, która ostatecznie tworzy sprzężenie między danymi macierzystymi Dataverse a danymi zewnętrznymi encji wirtualnej.

• Właściwości metadanych pola sprawdzane pod kątem poprawności w czasie aktualizacji nie dotyczą encji wirtualnych. Na przykład pole Liczba całkowita w polu encja wirtualna można ustawić na wartość minimalną wynoszącą zero. Jednak ponieważ wartość pochodzi z zewnętrznego źródła danych, zapytanie zwróci wartości mniejsze niż zero po pobraniu z encji wirtualnej. Właściwość minimalna wartość nie jest narzucana w zapytaniu. Nadal będziesz musiał filtrować wartości, które mają być większe niż 0, jeśli jest to konieczne.

• Encje wirtualne nie obsługują śledzenia zmian i nie mogą zostać zsynchronizowane za pomocą funkcji Customer Engagement, tak jak Usługa eksportowania danych.

• Przepływy procesów biznesowych nie są obsługiwane przez encje wirtualne. Więcej informacji: Nieoczekiwany błąd otrzymany, gdy użytkownik aktywuje przepływ procesu biznesowego

Nieoczekiwany błąd otrzymany, gdy użytkownik aktywuje przepływ procesu biznesowego

Kiedy użytkownik próbuje aktywować przepływ procesu biznesowego, może otrzymać komunikat o "nieoczekiwanym błędzie". Przeglądając plik dziennika, zobaczysz następujący wpis.

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Zgłoszono wyjątek typu 'System.Web.HttpUnhandledException'. ---> Microsoft.Crm.CrmException: Nie można włączyć przepływu procesów biznesowych dla Podmiotu wirtualnego

Ten problem występuje, ponieważ encje wirtualne nie obsługują przepływów procesów biznesowych.

Zobacz też

Konfiguracja dostawcy danych OData v4, wymagania i sprawdzone metody postępowania
Tworzenie i edytowanie encji
Tworzenie i edytowanie pól