De web-API gebruiken met Dynamics 365-metagegevens

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

U kunt met de web-API alle metagegevensbewerkingen uitvoeren die u kunt uitvoeren met de organisatieservice. Deze sectie biedt informatie over het gebruik van de web-API met de entiteitstypen in Web API Metadata EntityType Reference.

Er zijn vier entiteitenreekspaden beschikbaar om bewerkingen uit te voeren met metagegevensentiteiten, zoals wordt beschreven in de volgende tabel.

Entiteitenreekspad	Beschrijving
[Organization URI]/api/data/v8.2/EntityDefinitions	Bevat entiteiten van het type EntityMetadata EntityType.
[Organization URI]/api/data/v8.2/RelationshipDefinitions	Bevat ManyToManyRelationshipMetadata EntityType en OneToManyRelationshipMetadata EntityType aangezien beide overnemen van RelationshipMetadataBase EntityType.
[Organization URI]/api/data/v8.2/GlobalOptionSetDefinitions	Bevat globaal gedefinieerde entiteiten van het type BooleanOptionSetMetadata EntityType en OptionSetMetadata EntityType aangezien beide overnemen van OptionSetMetadataBase EntityType.
[Organization URI]/api/data/v8.2/ManagedPropertyDefinitions	Uitsluitend voor intern gebruik.

Elk entiteitstype voor metagegevens gebruikt MetadataId als de unieke ID-eigenschap, die wordt overgenomen van MetadataBase EntityType. Hoewel alle metagegevensentiteiten een MetadataId hebben, kunt u niet op al deze entiteiten rechtsreeks query's uitvoeren. U kunt bijvoorbeeld alleen query's uitvoeren en bewerkingen voor kenmerken uitvoeren in de context van de EntityMetadata-entiteit die deze bevat.

Er zijn enkele substantiële verschillen tussen deze entiteiten en de entiteiten waarin bedrijfs- en toepassingsgegevens worden opgeslagen, bijvoorbeeld:

• De eigenschappen voor metagegevensentiteiten gebruiken veel van de complexe en opsommingstypen die in Web API ComplexType Reference en Web API EnumType Reference zijn gedefinieerd in plaats van de primitieve gegevenstypen die worden gebruikt voor eigenschappen in entiteiten die overnemen van crmbaseentity EntityType.

• Voor metagegevensentiteiten wordt een andere naamgevingsconventie gehanteerd en wordt de naamgevingsstijl Pascal Case gebruikt in de assembly's van de organisatieservice.

• Metagegevensentiteiten maken meer gebruik van overname, waarvoor u casts moet uitvoeren om de gewenste gegevens op te halen.

In deze sectie

• Query's uitvoeren op metagegevens via de web-API
  U kunt de web-API gebruiken om query's op metagegevens uit te voeren op een manier die lijkt op wat u kunt doen met RetrieveMetadataChangesRequest en de objecten in de naamruimte Microsoft.Xrm.Sdk.Metadata.Query met de organisatieservice.

• Metagegevens ophalen op naam of MetadataId
  Uw toepassingen kunnen aan configuratiewijzigingen worden aangepast door middel van query's op metagegevens. Als u een van de kerneigenschappen van een metagegevensitem kent, kunt u metagegevensdefinities ophalen met de web-API.

• Entiteitsdefinities maken en bijwerken met behulp van de web-API
  U kunt entiteiten en kenmerken maken en bijwerken met de web-API om dezelfde resultaten te krijgen als met de organisatieservice CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest en UpdateAttributeRequest.

• Entiteitsrelaties maken en bijwerken met behulp van de web-API
  U kunt controleren of de entiteiten geschikt zijn om te worden gebruikt in een relatie met andere entiteiten en die relaties vervolgens maken of bijwerken met de web-API.

Zie ook

De metagegevens en gegevensmodellen in Microsoft Dynamics 365
Blader door de metagegevens voor uw organisatie
De organisatieservice met Dynamics 365-metagegevens gebruiken
De web-API van Microsoft Dynamics 365 gebruiken

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht