Configurazione e procedure consigliate per il Provider dati OData v4
Questo argomento si applica a Dynamics 365 Customer Engagement (on-premises). Per la versione Power Apps di questo argomento, vedi: Configurazione dei provider di 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
La tua istanza richiede che tutte le entità contengano un attributo di identificazione. Questo ID è noto come identificatore univoco e il valore deve essere un guid. È possibile mappare i campi ID solo ai campi esterni con il tipo di dati EDM.Guid. Non è possibile mappare un tipo di dati EDM.Int32 a un campo del tipo di dati uniqueidentifer.
Le entità OData con proprietà NULL devono essere impostate in modo da corrispondere al campo mappato nell'entità virtuale. Ad esempio, una proprietà dell'entità OData con Nullable=False deve disporre del campo mappato con l'attributo di requisito del campo 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. Per ulteriori informazioni, vedere Finestra di dialogo Impostazioni di sistema - scheda Personalizzazione
Mapping del tipo di dati
Nella tabella seguente vengono elencati i mapping del tipo di dati (EDM) del modello dati dell'entità OData con il tipo di dati appropriato.
| Tipo di dati OData | Tipo di dati |
|---|---|
| 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 entità 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 entità virtuali.
Passare a Impostazioni>.Amministrazione>Origini dati entità virtuali
Sulla barra degli strumenti Azioni seleziona Nuovo.
Nella finestra di dialogo Seleziona provider dati, selezionare una delle seguenti origini dati e quindi seleziona OK.
Provider dati OData v4. L'ambiente 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: Introduzione alle entità virtuali
Nella pagina delle proprietà Nuova origine dati, compilare i campi seguenti e quindi salvare il record.
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 usi il provider OData per connetterti 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 i record 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 $inclinecount. 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. Selezionare 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 entità virtuali che contengono dati da un'origine dati esterna
Blog TechNet: interagire con i dati da sistemi esterni utilizzando le nuove entità virtuali