Utilizzare l'API Web con i metadati di Dynamics 365

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Puoi eseguire una delle operazioni sui metadati con l'API Web che puoi eseguire utilizzando il servizio dell'organizzazione. In questa sezione sono disponibili le indicazioni per utilizzare l'API Web con i tipi di entità inclusi in Web API Metadata EntityType Reference.

Esistono quattro percorsi di set di entità esposti per eseguire operazioni con le entità dei metadati come descritto nella tabella seguente.

Percorso del set di entità	Descrizione
[URI organizzazione]/api/data/v8.2/EntityDefinitions	Contiene le entità EntityMetadata EntityType.
[URI organizzazione]/api/data/v8.2/RelationshipDefinitions	Contiene ManyToManyRelationshipMetadata EntityType e OneToManyRelationshipMetadata EntityType poiché entrambi ereditano da RelationshipMetadataBase EntityType.
[URI organizzazione]/api/data/v8.2/GlobalOptionSetDefinitions	Contiene le entità definite a livello globale BooleanOptionSetMetadata EntityType e OptionSetMetadata EntityType poiché entrambe ereditano da OptionSetMetadataBase EntityType.
[URI organizzazione]/api/data/v8.2/ManagedPropertyDefinitions	Solo per uso interno.

Ogni tipo di entità dei metadati utilizza MetadataId come proprietà di identificatore univoco che eredita da MetadataBase EntityType. Mentre tutte le entità dei metadati dispongono di un MetadataId, non puoi eseguire una query su tutte direttamente. Ad esempio, puoi eseguire query ed operazioni solo sugli attributi nel contesto dell'entità EntityMetadata che li contiene.

Queste entità hanno alcune differenze sostanziali rispetto alle entità utilizzate per l'archiviazione dei dati dell'applicazione e aziendali, ad esempio:

• Le proprietà delle entità dei metadati utilizzano molti tipi enum e complessi definiti inWeb API ComplexType Reference e Web API EnumType Reference anziché i tipi di dati primitivi utilizzati per le proprietà nelle entità che ereditano da crmbaseentity EntityType.

• Le entità dei metadati seguono una convenzione di denominazione diversa e mantengono lo stile di denominazione Pascal Case utilizzato negli assembly del servizio dell'organizzazione.

• Le entità dei metadati utilizzano in modo più esteso l'ereditarietà per cui poter essere necessario eseguire i cast per recuperare i dati desiderati.

In questa sezione

• Query sui metadati tramite la Web API
  Puoi utilizzare l'API Web per eseguire query sui metadati analogamente a RetrieveMetadataChangesRequest e agli oggetti nello spazio dei nomi Microsoft.Xrm.Sdk.Metadata.Query utilizzando il servizio dell'organizzazione.

• Recuperare i metadati per nome o MetadataId
  Le applicazioni possono adattarsi alle modifiche di configurazione tramite le query sui metadati. Quando conosci una delle proprietà chiave di un elemento di metadati, puoi recuperare le definizioni dei metadati tramite l'API Web.

• Creare e aggiornare definizioni di entità tramite la Web API
  Puoi creare e aggiornare le entità e gli attributi tramite l'API Web per raggiungere gli stessi risultati del servizio dell'organizzazione CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest e UpdateAttributeRequest.

• Creare e aggiornare relazioni di entità tramite l'API Web
  Puoi verificare se le entità sono idonee a partecipare a una relazione con altre entità e quindi creare o aggiornare tali relazioni tramite l'API Web.

Vedere anche

Modelli di dati e metadati in Microsoft Dynamics 365
Visualizzazione dei metadati per l'organizzazione
Utilizzare il servizio Organizzazione con i metadati di Dynamics 365
Utilizzare l'API Web di Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright