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

Artykuł
03/15/2023

Załóżmy, że chcesz mieć dostęp do danych osobowych kontaktu, utworzyć je, zaktualizować i usunąć z zewnętrznego konta źródło danych aplikacji opartej na modelu. W tym instruktażu modelem będzie wirtualna tabela o nazwie Osoba z kolumnami mapowanymi do schematu zewnętrznego, która pobiera dane 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.
Nie można używać dostawcy danych OData v4 do łączenia się z innym środowiskiem.

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

Nazwa kolumny zewnętrznej	Typ danych zewnętrznych	Typ danych tabeli wirtualnej	Przeznaczenie
Id	`Edm.Guid`	Klucz podstawowy	Klucz podstawowy dla tabeli
FirstName	`Edm.String`	Jeden wiersz tekstu	Imię klienta osoby
LastName	`Edm.String`	Jeden wiersz tekstu	Nazwisko osoby
Wiek	`Edm.Int32`	Liczba całkowita	Wiek osoby
LastModifiedOn	`Edm.DateTimeOffset`	Data i godzina	Ostatnia modyfikacja — data i godzina rekordu osoby

Metadane OData zewnętrznego źródła danych tabeli osoby:

OData zewnętrznego źródła danych XML, część 2.

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.

Pole	Wartość
Nazwa/nazwisko	Przykładowy adres źródła danych OData
Adres URL	`https://contosowebservice.azurewebsites.net/odata`
Przekroczenie limitu czasu	30
Zwróć liczbę encji w tekście	Stronicowanie po stronie klienta
Zwróć liczbę encji w tekście	Prawda

Pozostaw kolumny 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. Aby zrozumieć kolumny i typy danych odpowiednie dla tabeli, którą użytkownik jest zainteresowany, można dołączyć do końcu adresu URL /$metadata, aby zobaczyć definicję tabel w usłudze sieci Web.

Otwórz Eksplorator rozwiązań

Część nazwy tabeli niestandardowej stanowi prefiks dostosowywania. To jest ustawiane na podstawie wydawcy rozwiązania dla rozwiązania, w którym użytkownik pracuje. Upewnij się, że posługujesz się rozwiązaniem niezarządzanym, gdzie prefiks dostosowywania jest tym, którego chcesz dla tej tabeli. Więcej informacji: Zmień prefiks wydawcy rozwiązania

Otwieranie rozwiązania niezarządzanego

W portalu usługi Power Apps wybierz w lewym okienku nawigacji pozycję Rozwiązania, a następnie na pasku narzędzi wybierz pozycję Przełącz do widoku klasycznego. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.
Na liście Wszystkie rozwiązania otwórz odpowiednie rozwiązanie niezarządzane.

Tworzenie wirtualnej tabeli

W lewym okienku eksploratora rozwiązania, wybierz Encje, a następnie wybierz Nowa w okienku głównym.

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

Pole	Wartość
Źródło danych	Przykładowy adres źródła danych OData
Wyświetlana nazwa	Osoba
Nazwa w lm	Osoby
Nazwa/nazwisko	new_person
Nazwa zewnętrzna	Osoby
Nazwa kolekcji zewnętrznej	Osoby
Uwagi (z załącznikami)	wybrane
Działania	wybrane

Uwaga

Ścieżki zasobów OData używają EntitySet do identyfikowania zasobu. W przykładowej usłudze sieci Web OData EntitySet jest definiowana jako Osoby. Ta wartość jest używana jako nazwa zewnętrzna tabeli wirtualnej osoba.

Obok Obszary, w których encja jest wyświetlana, wybierz Sprzedaż, a następnie wybierz Zapisz (ale nie zamykaj formularza tabeli).

Utwórz kolumny dla wirtualnej tabeli

W lewym okienku nawigacji strony Encja: osoba wybierz Pola. W ramach tego instruktażu można edytować dwie istniejące kolumny i dodawać trzy kolejne kolumny, które są dostępne w pamięci źródła danych.

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. Zauważ, że kolumny klucza podstawowego są zawsze wymagane przez system.

Otwórz kolumnęnew_personid, a następnie zmień następującą właściwość z wartością podaną tutaj:

Nazwa zewnętrzna: Id
Wybierz pozycję Zapisz i zamknij.
Otwórz kolumnę new_name, a następnie zmień następujące właściwości z wartościami podanymi tutaj:
- Nazwa wyświetlana: Nazwisko
- Zewnętrzne nazwisko: LastName
Wybierz pozycję Zapisz i zamknij.

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

Pole	Wartość
Wyświetlana nazwa	Imię
Nazwa/nazwisko	new_firstname
Nazwa zewnętrzna	FirstName
Wymaganie dotyczące pola	Wymagany ze względów biznesowych
Typ danych	Jeden wiersz tekstu

Tworzenie kolumny wieku dla osoby.

Wybierz pozycję Zapisz i zamknij.
Wybierz Nowy, a następnie na stronie Pole: Nowy dla osoby wprowadź następujące informacje:

Pole Wartość

Wyświetlana nazwa Wiek

Nazwa/nazwisko new_age

Nazwa zewnętrzna Wiek

Wymaganie dotyczące pola Wymagany ze względów biznesowych

Typ danych Liczba całkowita
Wybierz pozycję Zapisz i zamknij.

Pole	Wartość
Wyświetlana nazwa	Wiek
Nazwa/nazwisko	new_age
Nazwa zewnętrzna	Wiek
Wymaganie dotyczące pola	Wymagany ze względów biznesowych
Typ danych	Liczba całkowita

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

Pole	Wartość
Wyświetlana nazwa	Data ostatniej modyfikacji
Nazwa/nazwisko	new_lastmodifiedon
Nazwa zewnętrzna	LastModifiedOn
Wymaganie dotyczące pola	Wymagany ze względów biznesowych
Typ danych	Data i godzina

Utwórz ostatnia modyfikacja dla kolumny.

Dodaj kolumnę do formularza głównego

W oknie encja Osoba, wybierz Formularze.
Otwórz formularz główny, przeciągnij i upuść kolumny Imię, Wiek i Ostatnia modyfikacja w prawym okienku do formularza w sekcji Ogólne.
W oknie tabeli Osoba, wybierz Zapisz i zamknij.

Konfigurowanie widoku domyślnego

W lewym okienku eksploratora rozwiązań w Encja osoby, wybierz Widoki.
Otwórz widok Wszystkie osoby.
W okienku Typowe zadania wybierz Dodaj kolumny.
Wybierz kolumny Imię, Wiek i Ostatnia modyfikacja, a następnie wybierz opcję OK.
W widoku: Wszystkie osoby, rozmieść kolejność kolumn, wybierając strzałkę w lewo i przenieś w prawo, a następnie wybierz opcję Zapisz i zamknij.
W oknie Eksploratorza rozwiązań kliknij Publikuj wszystkie dostosowania.
Po opublikowaniu wszystkich dostosowań zamknij okno Eksploratora rozwiązań.

Używanie wirtualnej tabeli w aplikacji opartej na modelu

Utwórz aplikację na podstawie modelu i dodaj tabelę Osoba do mapy witryny. Następnie wybierz formularz główny Osoba i widok Wcześniejsze wyszukiwanie dla osoby. Opublikuj aplikację. Więcej informacji tworzenie od podstaw pierwszej aplikacji opartej na modelu

Następnie użytkownicy aplikacji mogą wykonywać operacje odczytu, tworzenia, aktualizowania i usuwania przy użyciu tabeli wirtualnej, tak jak w każdej innej tabeli w Microsoft Dataverse.

Tworzenie, wyświetlanie i usuwanie rekordów przy użyciu tabeli wirtualnej

Uruchamianie aplikacji opartej na modelu. Wybierz opcję Nowy, wypełnij wymagane kolumny, a następnie zapisz rekord.
Wybierz ponownie opcję Nowy, aby utworzyć kolejny rekord i zapisać go.
Powinny się od teraz chcieć wyświetlić dwa rekordy podobne do poniższego w widoku Wszystkie osoby.
Aby usunąć rekord, wybierz rekord osoby, a następnie wybierz opcję Usuń. Potwierdź, aby usunąć rekord na stronie potwierdzenia.

Zobacz także

Konfiguracja dostawcy danych OData v4, wymagania i sprawdzone metody postępowania
Tworzenie i edytowanie tabeli wirtualnych, które zawierają dane z zewnętrznych źródeł danych