Bruge Web API med Dynamics 365-metadata

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Du kan udføre en hvilken som helst af metadatahandlingerne med den Web API, som du kan udføre ved hjælp af organisationstjenesten. Dette afsnit indeholder en vejledning om, hvordan du bruger Web API'en med de objekttyper, der er inkluderet i Web API Metadata EntityType Reference.

Der vises fire objektsætstier til udførelse af handlinger med metadataobjekter som beskrevet i følgende tabel.

Objektsætsti	Beskrivelse
[Organization URI]/api/data/v8.2/EntityDefinitions	Indeholder EntityMetadata EntityType-objekter.
[Organization URI]/api/data/v8.2/RelationshipDefinitions	Indeholder ManyToManyRelationshipMetadata EntityType og OneToManyRelationshipMetadata EntityType, fordi begge arver fra RelationshipMetadataBase EntityType.
[Organization URI]/api/data/v8.2/GlobalOptionSetDefinitions	Indeholder globalt definerede BooleanOptionSetMetadata EntityType og OptionSetMetadata EntityType-objekter, fordi begge arver fra OptionSetMetadataBase EntityType.
[Organization URI]/api/data/v8.2/ManagedPropertyDefinitions	Kun til intern brug.

Hver metadataobjekttype bruger MetadataId som entydigt id-egenskab, som den arver fra MetadataBase EntityType. Alle metadataobjekter har et MetadataId, men du kan ikke forespørge om dem direkte. For eksempel kan du kun forespørge om og udføre handlinger på attributter i forbindelse med det EntityMetadata-objekt, der indeholder dem.

Disse objekter har nogle væsentlige forskelle fra de objekter, der lagrer virksomheds- og programdata, for eksempel:

• Egenskaberne for metadataobjekter bruger mange af de komplekse typer og fastteksttyper, der er defineret i Web API ComplexType Reference og Web API EnumType Reference i stedet for de primitive datatyper, der bruges til egenskaber i objekter, der nedarver fra crmbaseentity EntityType.

• Metadataobjekter følger en anden navngivningskonvention og bruger den Pascal Case-navngivningsmåde, der anvendes i organisationstjenestens assemblier.

• Metadataobjekter gør i højere grad brug af arv, hvilket kræver, at du muligvis skal udføre konverteringer for at hente de ønskede data.

Dette afsnit indeholder

• Forespørg på metadata ved hjælp af Web-API'en
  Du kan bruge Web-API'en til at hente forespørgselsmetadata på en måde, der svarer til, hvad der kan gøres ved hjælp af RetrieveMetadataChangesRequest og objekterne i den Microsoft.Xrm.Sdk.Metadata.Query-navneområdet med oganisationstjenesten.

• Hente metadata efter navn eller MetadataId
  Dine programmer kan tilpasse sig ændringer i konfigurationen ved at forespørge om metadataene. Når du kender en af de vigtige egenskaber for et metadataelement, kan du hente metadatadefinitioner ved hjælp af Web API'en.

• Oprette og opdatere objektdefinitioner med Web API
  Du kan oprette og opdatere objekter og attributter ved hjælp af Web API'en for at opnå de samme resultater, du får med organisationstjenesten CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest og UpdateAttributeRequest.

• Oprette og opdatere objektrelationer med Web API
  Du kan kontrollere, om objekter er berettiget til at deltage i en relation med andre objekter og derefter oprette eller opdatere disse relationer ved hjælp af Web API'en.

Se også

Metadataene og datamodellerne i Microsoft Dynamics 365
Gennemse metadata for organisationen
Bruge organisationstjenesten med Dynamics 365-metadata
Brug Microsoft Dynamics 365 Web API

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret