Udostępnij przez


Przewodnik po tabeli wirtualnej przy użyciu dostawcy danych OData w wersji 4

Załóżmy, że chcesz uzyskać dostęp, utworzyć, zaktualizować i usunąć pewne dane osobowe dotyczące kontaktu z zewnętrznego źródła danych w aplikacji opartej na modelu. W tym instruktażu modelem będzie tabela wirtualna 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żyć dostawcy danych OData w wersji 4 do nawiązania połączenia z innym środowiskiem.

W tym przewodniku potrzebna jest pojedyncza tabela wirtualna zawierająca następujące kolumny.

Nazwa kolumny zewnętrznej Typ danych zewnętrznych Typ danych tabeli wirtualnej Przeznaczenie
Id Edm.Guid Klucz podstawowy Klucz podstawowy dla tabeli
Imię (pierwsze) Edm.String Jeden wiersz tekstu Imię osoby
Nazwisko Edm.String Jeden wiersz tekstu Nazwisko osoby
Wiek Edm.Int32 Liczbowy całkowity Wiek osoby
LastModifiedOn Edm.DateTimeOffset Dane i czas Dane i czas ostatniej modyfikacji rekordu osoby

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

Odata zewnętrzne źródło danych XML— część 2.

Tworzenie źródła 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).

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

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

  3. Wprowadź lub wybierz poniższe informacje.

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

Pozostaw pozostałe kolumny as-is, a następnie wybierz pozycję ZAPISZ i ZAMKNIJ.

Napiwek

Podczas korzystania z własnej usług sieci Web sprawdź, czy adres URL jest prawidłowy, wklejając go do przeglądarki sieci Web. Jeśli chcesz zrozumieć kolumny i typy danych odpowiednie dla interesującej Cię tabeli, możesz dołączyć /$metadata go na końcu adresu URL, aby wyświetlić definicję tabel w usłudze internetowej.

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 pracujesz w niezarządzanym rozwiązaniu, w którym prefiks dostosowywania jest odpowiedni dla tej tabeli. Więcej informacji: Zmienianie prefiksu wydawcy rozwiązania

Otwieranie rozwiązania niezarządzanego

  1. W usłudze Power Apps wybierz pozycję Rozwiązania w okienku nawigacji po lewej stronie, a następnie na pasku narzędzi wybierz pozycję Przełącz do wersji klasycznej. Jeśli elementu nie ma w okienku panelu bocznego, wybierz …Więcej, a następnie wybierz żądany element.

  2. Na liście Wszystkie rozwiązania otwórz żądane rozwiązanie niezarządzane.

Tworzenie tabeli wirtualnej

  1. W okienku nawigacji po lewej stronie Eksploratora rozwiązań wybierz pozycję Jednostki, a następnie wybierz pozycję Nowy w okienku głównym.

  2. W formularzu Entity: New (Jednostka: 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
    Nazwa wyświetlana Osoba
    Nazwa w liczbie mnogiej Osoby
    Nazwa nowa_osoba
    Nazwa zewnętrzna People
    Nazwa kolekcji zewnętrznej People
    Notatki (łącznie z załącznikami) wybrane
    Działania wybrane

    Uwaga / Notatka

    Semantyka ścieżki zasobów OData używa 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 dla tabeli wirtualnej Person.

  3. Obok obszarów, które wyświetlają tę jednostkę, wybierz Sprzedaż, a następnie wybierz Zapisz (lecz nie zamykaj tabeli z formularzem).

    Definicja tabeli osób.

Tworzenie kolumn dla tabeli wirtualnej

W lewym panelu nawigacyjnym strony Jednostka: osoba wybierz pozycję Pola. W ramach tego przewodnika będziesz edytować dwie istniejące kolumny i dodać trzy kolejne kolumny, które są dostępne w zewnętrznym źródle 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. Zwróć uwagę, że kolumny klucza podstawowego są zawsze wymagane przez system.

  1. Otwórz kolumnę new_personid i zmień następującą właściwość na wartość wskazaną tutaj:

    Nazwa zewnętrzna: identyfikator

    Utwórz kolumnę id.

  2. Wybierz pozycję Zapisz i zamknij.

  3. Otwórz kolumnę new_name i zmień następujące właściwości, aby wartości zostały wskazane tutaj:

    • Nazwa wyświetlana: Nazwisko
    • Nazwa zewnętrzna: LastName

    Utwórz kolumnę nazwiska.

  4. Wybierz pozycję Zapisz i zamknij.

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

    Pole Wartość
    Nazwa wyświetlana Imię
    Nazwa new_firstname
    Nazwa zewnętrzna Imię (pierwsze)
    Wymaganie dotyczące pola Wymagane dane firmowe
    Typ danych Jeden wiersz tekstu

    Utwórz kolumnę wieku dla osoby.

  6. Wybierz pozycję Zapisz i zamknij.

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

    Pole Wartość
    Nazwa wyświetlana Wiek
    Nazwa new_age
    Nazwa zewnętrzna Wiek
    Wymaganie dotyczące pola Wymagane dane firmowe
    Typ danych Liczbowy całkowity

    Utwórz kolumnę wieku.

  8. Wybierz pozycję Zapisz i zamknij.

  9. Wybierz pozycję Nowy, a następnie na stronie Pole: Nowa osoba wprowadź następujące informacje:

    Pole Wartość
    Nazwa wyświetlana Data ostatniej modyfikacji
    Nazwa new_lastmodifiedon
    Nazwa zewnętrzna LastModifiedOn
    Wymaganie dotyczące pola Wymagane dane firmowe
    Typ danych Data i godzina

    Utwórz ostatnią modyfikację w kolumnie.

Dodawanie kolumn do formularza głównego

  1. W oknie tabeli Person, wybierz pozycję Forms.

  2. Otwórz formularz główny, przeciągnij i upuść kolumny Imię, Wiek i Ostatnia modyfikacja w prawym okienku do formularza w sekcji Ogólne.

    Imię, wiek i ostatnia modyfikacja kolumn dodanych do formularza głównego.

  3. W oknie tabeli Osoba (Person) wybierz pozycję Zapisz i zamknij (Save and Close).

Konfigurowanie widoku domyślnego

  1. W lewym okienku eksploratora rozwiązań w Encja osoby, wybierz Widoki.
  2. Otwórz widok Wszystkie osoby .
  3. W okienku Typowe zadania wybierz pozycję Dodaj kolumny. Add columns for view.Dodaj kolumny dla widoku.
  4. Wybierz kolumny First Name (Imię),Age (Wiek) i Last Modified On (Ostatnia modyfikacja ), a następnie wybierz przycisk OK.
  5. W oknie Widok: Wszystkie osoby ustaw kolejność kolumn, wybierając strzałki przesunięcia w lewo i prawo, a następnie wybierz Zapisz i zamknij.
  6. W oknie Eksplorator rozwiązań wybierz pozycję Publikuj wszystkie dostosowania.
  7. Po opublikowaniu wszystkich dostosowań zamknij okno Eksploratora rozwiązań.

Używanie tabeli wirtualnej w aplikacji opartej na modelu

Utwórz aplikację opartą na modelu i dodaj tabelę Person do mapy witryny. Następnie wybierz formularz główny Osoby i widok Zaawansowanego wyszukiwania osoby. Opublikuj aplikację. Więcej informacji: Tworzenie pierwszej aplikacji opartej na modelu od podstaw

Następnie użytkownicy aplikacji mogą wykonywać operacje odczytu, tworzenia, aktualizowania i usuwania przy użyciu tabeli wirtualnej, podobnie jak każda inna tabela w usłudze Microsoft Dataverse.

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

  1. Uruchom aplikację opartą na modelu. Wybierz pozycję Nowy, wypełnij wymagane kolumny, a następnie zapisz rekord.
  2. Ponownie wybierz pozycję Nowy , aby utworzyć inny rekord i zapisać go.
  3. Teraz powinny istnieć dwa rekordy podobne do poniższych w widoku Wszystkie osoby . Wyświetl wszystkie osoby.
  4. Aby usunąć rekord, wybierz rekord osoby, a następnie wybierz pozycję Usuń. Potwierdź usunięcie rekordu na stronie potwierdzenia.

Zobacz także

Konfiguracja dostawcy danych OData v4, wymagania i najlepsze rozwiązania
Tworzenie i edytowanie tabeli wirtualnych, które zawierają dane z zewnętrznych źródeł danych