Configurazione, requisiti e procedure consigliate per il Provider dati OData v4

In questo argomento viene illustrato come configurare il Provider dati OData v4, nonché i requisiti e le procedure consigliate per l'utilizzo del Provider dati OData v4 per la connessione a un servizio Web OData v4.

Procedure consigliate per il Provider dati OData v4

• Microsoft Dataverse richiede che tutte le tabelle dispongano di un attributo ID; questo ID è noto come un identificatore univoco e il valore deve essere un guid. È possibile mappare le colonne ID solo a colonne esterne con il tipo di dati Edm.Guid. Non è possibile mappare un tipo di dati Edm.Int32 a una colonna del tipo di dati di identificatore univoco in Dataverse.
• Le tabelle OData con proprietà NULL devono essere impostate in modo da corrispondere alla colonna mappata nella tabella virtuale. Ad esempio, una proprietà della tabella OData con Nullable=False deve disporre della colonna mappata nell'attributo Requisito campo di Dataverse impostato su Obbligatorio per l'azienda.
• Per il recupero di più query, ad esempio quando si caricano dati in una griglia, controllare le dimensioni del set di dati restituito dall'origine dati esterna utilizzando i parametri di query di filtro e di selezione.
• Se non è già stata abilitata la funzionalità di analisi di plug-in, gli amministratori di sistema devono abilitarla. Dopo l'abilitazione, tutti gli errori provenienti dall'endpoint OData vengono acquisiti nel registro di analisi di plug-in. Ulteriori informazioni: Guida dell'amministratore: Finestra di dialogo Impostazioni di sistema - Scheda Personalizzazione
• Non è possibile utilizzare il provider di dati OData v4 per connettersi a un altro ambiente.

Mapping del tipo di dati

Nella tabella seguente vengono elencati i mapping del tipo di dati (EDM) del modello dati della tabella OData con i tipi di dati di Dataverse.

Tipo di dati OData	Tipo di dati Dataverse
Edm.Boolean	Due opzioni
Edm.DateTime	Data e ora
Edm.DateTimeOffset	Data e ora
Edm.Decimal	Numero decimale o valuta
Edm.Double	Numero a virgola mobile
Edm.Guid	Identificatore univoco
Edm.Int32	Numero intero
Edm.Int64	Numero intero
Edm.String	Riga singola di testo o più righe di testo

Tipi di dati EDM OData che non sono supportati per il mapping con tabelle virtuali

• Edm.Binary
• Edm.Time
• Edm.Float
• Edm.Single
• Edm.Int16
• Edm.Byte
• Edm.SByte

Aggiungere un'origine dati utilizzando il Provider dati OData v4

Questa procedura illustra come utilizzare il Provider dati OData predefinito da utilizzare come origine dati delle tabelle virtuali.

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

2. Nella barra degli strumenti Azioni fare clic su Nuovo.

3. Nella finestra di dialogo Seleziona provider dati selezionare dalle origini dati seguenti e quindi fare clic su OK.

   • Provider dati OData v4. Dataverse include un provider di dati Odata v4 che può essere utilizzato per la connessione alle origini dati che supportano lo standard aperto OData v4.
   • Provider di dati personalizzato. Se è stato importato un plug-nei provider di dati, il provider di dati verrà visualizzato qui. Ulteriori informazioni: Documentazione per sviluppatori: Introduzione alle tabelle virtuali

4. Nella pagina delle proprietà Nuova origine dati compila le colonne seguenti e quindi salva la riga.

   • Nome. Digitare un nome che descriva l'origine dati.
   • URI. Se si utilizza il Provider dati OData, immettere l'URI per il servizio Web OData. Ad esempio, se si utilizza il provider OData per connettersi a un servizio Web ospitato in Azure, l'URI può essere simile a https://contosodataservice.azurewebsites.net/odata/.
   • Timeout in secondi. Immettere il numero di secondi per attendere una risposta dal servizio Web prima di un timeout di richiesta dei dati. Ad esempio, immettere 30 per attendere un massimo di trenta secondi prima che si verifichi un timeout.
   • Modalità di paging. Selezionare l'opzione per utilizzare il paging lato client o lato server per controllare come vengono impaginati i risultati di query. Il valore predefinito è il paging lato client. Con il paging lato server, il server controlla come vengono impaginati i risultati utilizzando il parametro $skiptoken, che viene aggiunto alla stringa di query. Ulteriori informazioni: Opzione di query di sistema Skip Token ($skiptoken)
     • Restituisci conteggio inline. Restituisce le righe del numero totale nel set di risultati. Questa impostazione è utilizzata per abilitare la funzionalità della pagina seguente quando si restituiscono dati in una griglia. Utilizzare un valore false se l'endpoint OData non supporta il parametro OData $inlinecount. Il valore predefinito è false.
   • Parametri richiesta. Se lo si desidera, è possibile aggiungere parametri stringa di query o di intestazione personalizzati da utilizzare per la connessione al servizio Web OData, ad esempio i parametri di autenticazione al servizio esterno. Fare clic Stringa di query per passare alternativamente dal parametro stringa di query e intestazione al valore. È possibile aggiungere fino a 10 stringhe di intestazione o query.

     

Vedi anche

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).