Udostępnij za pośrednictwem

Przewodnik po wirtualnej encji przy użyciu dostawcy danych OData v4

  • Artykuł

Załóżmy, że chcesz mieć dostęp do danych osobowych kontaktu, tworzyć je, aktualizować i usuwać z zewnętrznego źródła danych za pomocą swojej niestandardowej aplikacji biznesowej. Ponieważ źródło danych użyte dla tego instruktarza zawiera usługę sieci Web OData v4, możemy użyć dostawcy danych OData v4 dołączonego do Twojej wersji Dynamics 365 Customer Engagement. WIęcej informacji: Przewodnik po wirtualnej tabeli przy użyciu dostawcy danych OData v4

Ten temat dotyczy platformy Dynamics 365 Customer Engagement (on-premises). Aby zapoznać się z wersją tego tematu dotyczącą usługi Power Apps, zobacz: Przewodnik po wirtualnej tabeli

Informacje o tym przewodniku po encji wirtualnej

Załóżmy, że chcesz uzyskać dostęp do informacji biletowej z zewnętrznego źródła danych w niestandardowej aplikacji biznesowej lub obszaru Customer Engagement. W tym instruktażu modelem będzie wirtualna encja z polami mapowanymi do schematu zewnętrznego, który pobiera dane o biletach w czasie wykonywania z usługi sieci web OData.

Szczegóły dotyczące źródła danych

Ponieważ źródło danych użyte dla tego instruktarza zawiera usługę sieci Web OData v4, możemy użyć dostawcy danych OData v4 dołączonego do środowiska.

Adres url usługi sieci Web: https://contosowebservice.azurewebsites.net/odata/

Ważne

Adres url usługi w sieci Web dla tego przewodnika nie jest aktywną usługą sieci Web.

W tym przewodniku potrzebna jest pojedyncza encja wirtualna, która zawiera następujące trzy pola.

Nazwa pola zewnętrznego Typ danych zewnętrznych Typ danych encji wirtualnej Cel
TicketID Edm.Guid Klucz podstawowy Klucz podstawowy dla encji.
Tytuł Edm.String Jeden wiersz tekstu Tytuł biletu.
Ważność Edm.Int32 Liczba całkowita Wartość od 0 do 4 wskazująca ważność biletu

Metadane OData encji Bilet zewnętrznego źródła danych wyświetlane w przeglądarce sieci Web.

Metadane encji Bilet.

Utwórz źródło danych

Utwórz źródło danych dla dostawcy danych OData v4, który korzysta z przykładowej usługi sieci Web OASIS Open Data Protocol (OData).

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

Wybierz NOWY, wybierz Dostawca danych Data v4, a następnie wybierz OK.

Wprowadź lub wybierz poniższe informacje.

  • Nazwa: Przykładowe źródło danych Contoso
  • Adres URL: https://contosowebservice.azurewebsites.net/odata
  • Limit czasu: 30
  • Zwróć liczbę encji w tekście: Prawda

Pozostaw pola w takim stanie, w jakim się znajdują i wybierz ZAPISZ i ZAMKNIJ.

Porada

Podczas korzystania z własnej usług sieci Web sprawdź, czy adres URL jest prawidłowy, wklejając go do przeglądarki sieci Web.

Tworzenie encji wirtualnej

Przejdź do Ustawienia>Dostosowywanie>Dostosuj system.

W lewym okienku nawigacji, wybierz Encje, a następnie wybierz Nowa w okienku głównym.

Na formularzu Encja: Nowa wybierz opcję Encja wirtualna, a następnie wprowadź następujące informacje:

  • Źródło danych: Przykładowe źródło danych Contoso
  • Nazwa wyświetlana: Bilet
  • Nazwa w liczbie mnogiej: Bilety
  • Nazwa: new_ticket
  • Nazwa zewnętrzna: Bilet
  • Nazwa kolekcji zewnętrznej: Bilety
  • Wybierz, aby włączyć następujące opcje Komunikacji i współpracy:
    • Uwagi (z załącznikami)
    • Działania

Obok Obszary, w których encja jest wyświetlana, wybierz Usługa, a następnie wybierz Zapisz (ale nie zamykaj formularza encji).

Definicja encji biletu.

Utwórz pola dla encji wirtualnej

W lewym okienku nawigacji strony Encja: Bilet wybierz Pola. W ramach tego przewodnika przeprowadzisz edycję dwóch istniejących pól i dodasz trzecie pole.

Ważne

W nazwach zewnętrznych jest rozróżniana wielkość liter. Odnieś się do metadanych usługi sieci Web, aby się upewnić, że korzystasz z poprawnej nazwy.

Wartość NULL wskazuje, że jest wymagany atrybut. Należy zauważyć, że pola klucza podstawowego są zawsze wymagane przez system.

Otwórz pole new_ticketid, a następnie zmień następujący atrybut z wartością podaną tutaj:

Nazwa zewnętrzna: TicketID

Pole TicketID.

Wybierz pozycję Zapisz i zamknij.

Otwórz pole new_name, a następnie zmień następujące atrybuty z wartościami podanymi tutaj:

  • Nazwa wyświetlana: Tytuł
  • Nazwa zewnętrzna: Tytuł

Pole Tytuł.

Wybierz pozycję Zapisz i zamknij.

Wybierz Nowy, a następnie na stronie Pole: Nowy dla Bilet wprowadź następujące informacje:

  • Nazwa wyświetlana: Ważność
  • Nazwa: new_severity
  • Nazwa zewnętrzna: Ważność
  • Wymaganie dotyczące pola: Wymaganie biznesowe
  • Typ danych: Liczba całkowita
  • Minimalna wartość: 0
  • Maksymalna wartość: 4

Pole Ważność.

Wybierz pozycję Zapisz i zamknij.

Dodaj pole do formularza Główny

W oknie encja Bilet, wybierz Formularze.

Otwórz formularz główny, przeciągnij i upuść pole Ważność z prawego okienka do formularza w sekcji Ogólne w polu Tytuł.

Pole Ważność dodane do głównego formularza.

W oknie encja Bilet, wybierz Zapisz i zamknij.

Konfigurowanie widoku domyślnego

W lewym okienku Eksploratora rozwiązań w Encja Bilet, wybierz Widoki.

Otwórz widok Wszystkie bilety.

W okienku Typowe zadania wybierz Dodaj kolumny.

Dodaj kolumny dla widoku.

Wybierz Ważność, a następnie wybierz OK.

W oknie Widok: Wszystkie bilety wybierz Zapisz i zamknij.

W oknie Eksploratorza rozwiązań kliknij Publikuj wszystkie dostosowania.

Opublikuj wszystkie dostosowania.

Po opublikowaniu wszystkich dostosowań zamknij okno Eksploratora rozwiązań.

Zobacz encję wirtualną podczas jej działania z Dynamics 365 Customer Engagement (on-premises)

Przejdź do Usługa>Rozszerzenia>Bilety.

Obszar Bilet.

Wyświetlane w widoku Wszystkie bilety. Należy pamiętać, że może trzeba odświeżyć przeglądarkę, aby wyświetlić encję z obszaru Usługa.

Widok Wszystkie bilety.

Otwórz rekord Bilet, aby wyświetlić formularz, który zawiera pola Tytuł i Ważność dla danego rekordu.

Rekord bilet.

Zobacz także

Konfiguracja dostawcy danych OData v4, wymagania i sprawdzone metody postępowania

Tworzenie i edytowanie encji wirtualnych, które zawierają dane z zewnętrznych źródeł danych