Procedura dettagliata per le tabelle virtuali che utilizzano il provider di dati OData v4

  • Articolo

Immagina di voler accedere, creare, aggiornare ed eliminare alcune informazioni personali su un contatto da un origine dati esterna all'interno della tua app basata su modello. In questa semplice procedura dettagliata, modellerai una tabella virtuale denominata Persona con le colonne mappate allo schema esterno su queste operazioni in runtime da un servizio Web OData.

Dettagli dell'origine dati

Poiché l'origine dati utilizzata per questa procedura dettagliata include un servizio Web OData v4, possiamo utilizzare il provider di dati OData v4 presente nell'ambiente.

URL del servizio Web: https://contosowebservice.azurewebsites.net/odata/

Importante

  • L'URL del servizio Web utilizzato per questa procedura dettagliata non è un servizio Web funzionante.
  • Non è possibile utilizzare il provider di dati OData v4 per connettersi a un altro ambiente.

Per questa procedura dettagliata, è necessaria una sola tabella virtuale contenente le colonne seguenti.

Nome colonna esterno Tipo di dati esterni Tipo di dati tabella virtuale Scopo
ID Edm.Guid Chiave primaria Chiave primaria per la tabella
FirstName Edm.String Riga di testo singola Nome della persona
LastName Edm.String Riga di testo singola Cognome della persona
Età Edm.Int32 Numero intero Età della persona
LastModifiedOn Edm.DateTimeOffset Data e ora Data e ora dell'ultima modifica del record della persona

Metadati OData della tabella persona dell'origine dati esterna:

XML origine dati esterna Odata parte 2.

Creare l'origine dati

Crea l'origine dati per il provider di dati OData v4 che utilizza il servizio Web di esempio con protocollo OData OASIS.

  1. Passare a Impostazioni > .Amministrazione > Origini dati entità virtuali

  2. Seleziona NUOVO, Provider dati OData v4 e quindi OK.

  3. Immetti o seleziona le informazioni seguenti.

    Campo valore
    Nome Origine dati OData di esempio persona
    URL https://contosowebservice.azurewebsites.net/odata
    Timeout 30
    Restituisci conteggio inline Paging lato client
    Restituisci conteggio inline Vero

Lascia immutati le altre colonne e seleziona SALVA e CHIUDI.

Suggerimento

Quando utilizzi il servizio Web personale, verifica che l'URL sia valido incollandolo nel browser Web. Se vuoi capire le colonne e i tipi di dati relativi alla tabella che ti interessa, puoi aggiungere /$metadata alla fine del tuo URL per vedere la definizione delle tabelle nel tuo servizio Web.

Aprire Esplora soluzioni.

Parte del nome di qualsiasi tabella personalizzata creata è il prefisso di personalizzazione. È impostato in base all'autore della soluzione che utilizzi. Verifica di utilizzare una soluzione non gestita in cui il prefisso di personalizzazione sia quello che desideri per questa tabella. Ulteriori informazioni: Modificare il prefisso dell'autore di soluzioni

Aprire una soluzione non gestita

  1. Da Power Apps seleziona Soluzioni dal riquadro di spostamento sinistro, quindi sulla barra degli strumenti, seleziona Passa a modalità classica. Se l'elemento non si trova nel riquadro del pannello laterale, seleziona …Altro, quindi l'elemento desiderato.

  2. Nell'elenco Tutte le soluzioni aprire la soluzione non gestita desiderata.

Creare una tabella virtuale

  1. Nel riquadro di spostamento di sinistra in Esplora soluzioni, seleziona Entità e quindi Nuovo nel riquadro principale.

  2. Nel modulo Nuova entità, seleziona l'opzione Tabella virtuale e quindi immetti le informazioni seguenti:

    Campo valore
    Origine dati Origine dati OData di esempio persona
    Nome visualizzato Persona
    Nome plurale Persone
    Nome new_person
    Nome esterno Persone
    Nome raccolta esterno Persone
    Nota (include allegati) selezionato
    Impegni selezionato

    Nota

    La semantica del percorso della risorsa OData utilizza EntitySet per identificare la risorsa. Nel servizio Web OData di esempio, EntitySet è definito come Persone. Questo valore viene utilizzato come Nome esterno per l'oggetto Persona della tabella virtuale.

  3. Accanto a Aree in cui viene visualizzata l'entità, seleziona Vendite e seleziona Salva (ma non chiudere il modulo della tabella). Definzione della tabella Persona.

Creare le colonne per la tabella virtuale

Nel riquadro di spostamento sinistro della pagina Entità: Persona, seleziona Campi. Come parte di questa procedura dettagliata, modificherai due colonne esistenti e aggiungerai altre tre colonne disponibili nell'origine dati esterna.

Importante

Per i nomi esterni è rilevante la distinzione tra maiuscole e minuscole. Fai riferimento ai metadati del tuo servizio Web per assicurarti di utilizzare il nome corretto. Un valore nullable false indica che l'attributo è obbligatorio. Nota che le colonne della chiave primaria sono sempre obbligatorie per il sistema.

  1. Apri la colonna new_personid e modifica la seguente proprietà con il valore indicato di seguito:

    Nome esterno: ID

    Crea colonna ID.

  2. Seleziona Salva e chiudi.

  3. Apri la colonna new_name e modifica le seguenti proprietà per avere i valore indicati di seguito:

    • Nome visualizzato: Cognome
    • Nome esterno: LastName

    Crea la colonna del cognome.

  4. Seleziona Salva e chiudi.

  5. Seleziona Nuovo e nella pagina Campo: Nuovo per Persona immetti le informazioni seguenti:

    Campo valore
    Nome visualizzato Nome
    Nome new_firstname
    Nome esterno FirstName
    Requisito campo Obbligatorio per l'azienda
    Tipo di dati Riga di testo singola

    Crea colonna età per persona.

  6. Seleziona Salva e chiudi.

  7. Seleziona Nuovo e nella pagina Campo: Nuovo per Persona immetti le informazioni seguenti:

    Campo valore
    Nome visualizzato Età
    Nome new_age
    Nome esterno Età
    Requisito campo Obbligatorio per l'azienda
    Tipo di dati Numero intero

    Crea colonna età.

  8. Seleziona Salva e chiudi.

  9. Seleziona Nuovo e nella pagina Campo: Nuovo di Persona immetti le informazioni seguenti:

    Campo valore
    Nome visualizzato Data ultima modifica
    Nome new_lastmodifiedon
    Nome esterno LastModifiedOn
    Requisito campo Obbligatorio per l'azienda
    Tipo di dati Data e ora

    Crea ultima modifica sulla colonna.

Aggiungere le colonne al modulo principale

  1. Nella finestra della tabella Persona, seleziona Moduli.

  2. Apri il modulo principale, trascina e rilascia le colonne Nome, Età e Ultima modifica in data dal riquadro di destra sul modulo nella sezione Generale.

    Nome, età e ultima modifica sulle colonne aggiunte al modulo principale.

  3. Nella finestra della tabella Persona, seleziona Salva e chiudi.

Configurare la visualizzazione predefinita

  1. Nel riquadro sinistro di Esplora soluzioni, sotto Entità Persona, seleziona Visualizzazioni.
  2. Apri la visualizzazione Tutte le persone.
  3. Nel riquadro Attività comuni seleziona Aggiungi colonne. Aggiungere colonne per la visualizzazione.
  4. Seleziona le colonne Nome, Età e Ultima modifica in data, quindi seleziona OK.
  5. Nella finestra Visualizza: Tutte le persone, organizza l'ordine delle colonne selezionando le frecce sposta a sinistra e sposta a destra, quindi selezionare Salva e chiudi.
  6. Nella finestra Esplora soluzioni seleziona Pubblica tutte le personalizzazioni.
  7. Dopo la pubblicazione di tutte le personalizzazioni, chiudi la finestra Esplora soluzioni.

Utilizzare la tabella virtuale in un'app basata su modello

Crea un'app basata su modello e aggiungi la tabella Persona alla mappa del sito. Quindi, seleziona il modulo principale Persona e la visualizzazione Ricerca avanzata persone. Pubblica l'app. Altre informazioni: Creare da zero la prima app basata su modello

Quindi, gli utenti dell'app possono eseguire operazioni di lettura, creazione, aggiornamento ed eliminazione utilizzando la tabella virtuale proprio come qualsiasi altra tabella in Microsoft Dataverse.

Creare, visualizzare ed eliminare record utilizzando la tabella virtuale

  1. Esegui l'app basata su modello. Seleziona Nuovo, completa le colonne obbligatorie, quindi salva il record.
  2. Seleziona Nuovo per creare un altro record e salvarlo.
  3. Ora dovresti avere due record simili al seguente nella visualizzazione Tutte le persone. Visualizza tutte le persone.
  4. Per eliminare un record, seleziona il record persona, quindi seleziona Elimina. Conferma per eliminare il record nella pagina di conferma.

Vedi anche

Configurazione, requisiti e procedure consigliate per il Provider dati OData v4
Creare e modificare tabelle virtuali che contengono dati da un'origine dati esterna

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).