Entiteitsdefinities maken en bijwerken met behulp van de web-API

Artikel
03/04/2017

Gepubliceerd: januari 2017

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

Alle bewerkingen die u kunt uitvoeren met de organisatieservice kunt u ook uitvoeren op modelentiteiten. Dit onderwerp is gericht op het werken met metagegevensentiteiten met behulp van de web-API. Voor details over de eigenschappen van entiteitsmetagegevens raadpleegt u Metagegevens van entiteiten aanpassen en EntityMetadata EntityType.

In dit onderwerp

Entiteiten maken

Entiteiten bijwerken

Kenmerken maken

Entiteiten maken

Als u een entiteit wilt maken, POST u de JSON-weergave van de entiteitgegevens op het EntityDefinitions-entiteitenreekspad. De entiteit moet de definitie voor het primaire-naamkenmerk voor de entiteit bevatten. U hoeft geen waarden in te stellen voor alle eigenschappen. De items in deze lijst, met uitzondering van Description, zijn vereist, maar de instelling van een beschrijving wordt een aanbevolen procedure. De eigenschapswaarden die u opgeeft worden ingesteld op standaardwaarden. Als u de standaardwaarden wilt begrijpen, bekijkt u het voorbeeld in de sectie Entiteiten bijwerken. In het voorbeeld in dit onderwerp worden de volgende entiteitseigenschappen gebruikt.

Entiteitseigenschap	Waarde
SchemaName	new_BankAccount Notitie U kunt het beste het aanpassingsprefix opnemen dat overeenkomt met de oplossingsuitgever. Hier wordt de standaardwaarde "nieuw_" gebruikt, maar u kunt het prefix kiezen dat werkt voor uw oplossing.
DisplayName	Bankrekening
DisplayCollectionName	Bankrekeningen
Description	Een entiteit voor het opslaan van informatie over bankrekeningen van klanten.
OwnershipType	UserOwned Notitie Voor de waarden die u hier kunt instellen, raadpleegt u OwnershipTypes EnumType.
IsActivity	false
HasActivities	false
HasNotes	false

Naast de eerder vermelde eigenschappen, moet de eigenschap EntityMetadataAttributes een matrix bevatten die één StringAttributeMetadata EntityType bevat om het primaire-naamkenmerk voor de entiteit weer te geven. De kenmerkeigenschap IsPrimaryName moet waar zijn. In de volgende tabel worden de eigenschappen beschreven die in het voorbeelden worden ingesteld.

Primaire kenmerkeigenschap	Waarde
SchemaName	new_AccountName
RequiredLevel	None Notitie Voor de waarden die u hier kunt instellen, raadpleegt u AttributeRequiredLevelManagedProperty ComplexType en AttributeRequiredLevel EnumType.
MaxLength	100
FormatName	Text Notitie Het primaire-naamkenmerk moet gebruikmaken van de Text-indeling. Voor indelingsopties die beschikbaar zijn voor andere tekenreekskenmerken, raadpleegt u StringAttributeMetadata-indelingen
DisplayName	Accountnaam
Description	Typ de naam van de bankrekening.
IsPrimaryName	true

Notitie

Wanneer u labels maakt of bijwerkt met het Label ComplexType, hoeft u alleen de eigenschap LocalizedLabels in te stellen. De UserLocalizedLabel-waarde die wordt geretourneerd is gebaseerd op de taalvoorkeur van de gebruiker en is alleen-lezen.

In het volgende voorbeeld wordt het maken van een aangepaste entiteit met de ingestelde eigenschappen weergegeven. De taal is Engels en de landinstellingen-id (lcid) is 1033.U vindt de geldige lokale id-waarden in het Diagram van LCID (id van landinstelling).

Aanvraag

POST cc_WebAPI_ServiceURI/EntityDefinitions HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
  "@odata.type": "Microsoft.Dynamics.CRM.EntityMetadata",
 "Attributes": [
  {
   "AttributeType": "String",
   "AttributeTypeName": {
    "Value": "StringType"
   },
   "Description": {
     "@odata.type": "Microsoft.Dynamics.CRM.Label",
    "LocalizedLabels": [
     {
       "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
      "Label": "Type the name of the bank account",
      "LanguageCode": 1033
     }
    ]
   },
   "DisplayName": {
     "@odata.type": "Microsoft.Dynamics.CRM.Label",
    "LocalizedLabels": [
     {
       "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
      "Label": "Account Name",
      "LanguageCode": 1033
     }
    ]
   },
   "IsPrimaryName": true,
   "RequiredLevel": {
    "Value": "None",
    "CanBeChanged": true,
    "ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
   },
   "SchemaName": "new_AccountName",
    "@odata.type": "Microsoft.Dynamics.CRM.StringAttributeMetadata",
   "FormatName": {
    "Value": "Text"
   },
   "MaxLength": 100
  }
 ],
 "Description": {
   "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
     "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "An entity to store information about customer bank accounts",
    "LanguageCode": 1033
   }
  ]
 },
 "DisplayCollectionName": {
   "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
     "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Bank Accounts",
    "LanguageCode": 1033
   }
  ]
 },
 "DisplayName": {
   "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
     "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Bank Account",
    "LanguageCode": 1033
   }
  ]
 },
 "HasActivities": false,
 "HasNotes": false,
 "IsActivity": false,
 "OwnershipType": "UserOwned",
 "SchemaName": "new_BankAccount"
}

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: cc_WebAPI_ServiceURI/EntityDefinitions(417129e1-207c-e511-80d2-00155d2a68d2)

Entiteiten bijwerken

Belangrijk

U kunt de methode HTTP PATCH niet gebruiken om modelentiteiten bij te werken. De metagegevensentiteiten hebben pariteit met de organisatieservice UpdateEntityRequest die de entiteitdefinitie vervangt door de opgenomen definitie. Daarom moet u de methode HTTP PUT gebruik bij het bijwerken van modelentiteiten en zorgvuldig alle bestaande eigenschappen opnemen die u niet wilt wijzigen. U kunt geen afzonderlijke eigenschappen bijwerkt.

Wanneer u metagegevensentiteiten met labels bijwerkt, moet u een aangepaste MSCRM.MergeLabels-koptekst opnemen om te bepalen hoe alle labels in de update moeten worden behandeld. Als een label voor een item al labels voor andere talen heeft en u deze bijwerkt met een label dat slechts één label voor een specifieke taal bevat, bepaalt de MSCRM.MergeLabels-koptekst of de bestaande labels moeten worden overschreven dan wel of uw nieuw label moet worden samengevoegd met bestaande taallabels. Als MSCRM.MergeLabels is ingesteld op true, overschrijven eventuele nieuwe gedefinieerde labels alleen bestaande labels als de taalcode overeenkomt. Als u de bestaande labels wilt overschrijven zodat alleen de labels overblijven die u opneemt, stelt u MSCRM.MergeLabels in op false.

Belangrijk

Als u geen MSCRM.MergeLabels-koptekst opneemt, wordt standaard uitgegaan van false als waarde en gaan gelokaliseerde labels die niet zijn opgenomen in uw update verloren.

Als u een entiteit of kenmerk bijwerkt, moet u de PublishXml Action of PublishAllXml Action gebruiken om de wijzigingen die u maakt toe te passen in de toepassing.Meer informatie:Aanpassingen publiceren

Normaal gesproken, haalt u de JSON-definitie van het kenmerk op en wijzigt u de eigenschappen voordat u deze terugstuurt. Het volgende voorbeeld bevat alle metagegevenseigenschappen van de entiteit die is gemaakt in het voorbeeld Entiteiten maken, maar met de DisplayName gewijzigd in "Bank Business Name". Het kan handig zijn zich te realiseren dat JSON hier de standaardwaarden biedt voor eigenschappen die niet zijn ingesteld in het voorbeeld Entiteiten maken.

Aanvraag

PUT cc_WebAPI_ServiceURI/EntityDefinitions(417129e1-207c-e511-80d2-00155d2a68d2) HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
MSCRM.MergeLabels: true

{
 "@odata.context": "cc_WebAPI_ServiceURI/$metadata#EntityDefinitions/$entity",
 "ActivityTypeMask": 0,
 "AutoRouteToOwnerQueue": false,
 "CanTriggerWorkflow": true,
 "Description": {
  "LocalizedLabels": [
   {
    "Label": "An entity to store information about customer bank accounts",
    "LanguageCode": 1033,
    "IsManaged": false,
    "MetadataId": "edc3abd7-c5ae-4822-a3ed-51734fdd0469",
    "HasChanged": null
   }
  ]
 },
 "DisplayCollectionName": {
  "LocalizedLabels": [
   {
    "Label": "Bank Accounts",
    "LanguageCode": 1033,
    "IsManaged": false,
    "MetadataId": "7c758e0c-e9cf-4947-93b0-50ec30b20f60",
    "HasChanged": null
   }
  ]
 },
 "DisplayName": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Bank Business Name",
    "LanguageCode": 1033
   }
  ]
 },
 "EntityHelpUrlEnabled": false,
 "EntityHelpUrl": null,
 "IsDocumentManagementEnabled": false,
 "IsOneNoteIntegrationEnabled": false,
 "IsInteractionCentricEnabled": false,
 "IsKnowledgeManagementEnabled": false,
 "AutoCreateAccessTeams": false,
 "IsActivity": false,
 "IsActivityParty": false,
 "IsAuditEnabled": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyauditsettings"
 },
 "IsAvailableOffline": false,
 "IsChildEntity": false,
 "IsAIRUpdated": false,
 "IsValidForQueue": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyqueuesettings"
 },
 "IsConnectionsEnabled": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyconnectionsettings"
 },
 "IconLargeName": null,
 "IconMediumName": null,
 "IconSmallName": null,
 "IsCustomEntity": true,
 "IsBusinessProcessEnabled": false,
 "IsCustomizable": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "iscustomizable"
 },
 "IsRenameable": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "isrenameable"
 },
 "IsMappable": {
  "Value": true,
  "CanBeChanged": false,
  "ManagedPropertyLogicalName": "ismappable"
 },
 "IsDuplicateDetectionEnabled": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyduplicatedetectionsettings"
 },
 "CanCreateAttributes": {
  "Value": true,
  "CanBeChanged": false,
  "ManagedPropertyLogicalName": "cancreateattributes"
 },
 "CanCreateForms": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "cancreateforms"
 },
 "CanCreateViews": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "cancreateviews"
 },
 "CanCreateCharts": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "cancreatecharts"
 },
 "CanBeRelatedEntityInRelationship": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canberelatedentityinrelationship"
 },
 "CanBePrimaryEntityInRelationship": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canbeprimaryentityinrelationship"
 },
 "CanBeInManyToMany": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canbeinmanytomany"
 },
 "CanEnableSyncToExternalSearchIndex": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canenablesynctoexternalsearchindex"
 },
 "SyncToExternalSearchIndex": false,
 "CanModifyAdditionalSettings": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyadditionalsettings"
 },
 "CanChangeHierarchicalRelationship": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canchangehierarchicalrelationship"
 },
 "IsOptimisticConcurrencyEnabled": true,
 "ChangeTrackingEnabled": false,
 "IsImportable": true,
 "IsIntersect": false,
 "IsMailMergeEnabled": {
  "Value": true,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifymailmergesettings"
 },
 "IsManaged": false,
 "IsEnabledForCharts": true,
 "IsEnabledForTrace": false,
 "IsValidForAdvancedFind": true,
 "IsVisibleInMobile": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifymobilevisibility"
 },
 "IsVisibleInMobileClient": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifymobileclientvisibility"
 },
 "IsReadOnlyInMobileClient": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifymobileclientreadonly"
 },
 "IsOfflineInMobileClient": {
  "Value": false,
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifymobileclientoffline"
 },
 "DaysSinceRecordLastModified": 0,
 "IsReadingPaneEnabled": true,
 "IsQuickCreateEnabled": false,
 "LogicalName": "new_bankaccount",
 "ObjectTypeCode": 10009,
 "OwnershipType": "UserOwned",
 "PrimaryNameAttribute": "new_accountname",
 "PrimaryImageAttribute": null,
 "PrimaryIdAttribute": "new_bankaccountid",
 "Privileges": [
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvCreatenew_BankAccount",
   "PrivilegeId": "d1a8de4b-27df-42e1-bc5c-b863e002b37f",
   "PrivilegeType": "Create"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvReadnew_BankAccount",
   "PrivilegeId": "726043b1-de2c-487e-9d6d-5629fca2bf22",
   "PrivilegeType": "Read"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvWritenew_BankAccount",
   "PrivilegeId": "fa50c539-b6c7-4eaf-bd49-fd8224bc51b6",
   "PrivilegeType": "Write"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvDeletenew_BankAccount",
   "PrivilegeId": "17c1fd6e-f856-45e7-b563-796f53108b85",
   "PrivilegeType": "Delete"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvAssignnew_BankAccount",
   "PrivilegeId": "133ca81d-668e-4c19-a71e-10c6dfe099cd",
   "PrivilegeType": "Assign"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvSharenew_BankAccount",
   "PrivilegeId": "15f27df4-9c67-47c9-b1f1-274e1c44f24a",
   "PrivilegeType": "Share"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvAppendnew_BankAccount",
   "PrivilegeId": "ac8b1920-8f93-4e9d-94e3-c680e2a2f228",
   "PrivilegeType": "Append"
  },
  {
   "CanBeBasic": true,
   "CanBeDeep": true,
   "CanBeGlobal": true,
   "CanBeLocal": true,
   "CanBeEntityReference": false,
   "CanBeParentEntityReference": false,
   "Name": "prvAppendTonew_BankAccount",
   "PrivilegeId": "f63a5f46-3bc7-4eac-81d0-7f77f566ef46",
   "PrivilegeType": "AppendTo"
  }
 ],
 "RecurrenceBaseEntityLogicalName": null,
 "ReportViewName": "Filterednew_BankAccount",
 "SchemaName": "new_BankAccount",
 "IntroducedVersion": "1.0",
 "IsStateModelAware": true,
 "EnforceStateTransitions": false,
 "EntityColor": null,
 "LogicalCollectionName": "new_bankaccounts",
 "CollectionSchemaName": "new_BankAccounts",
 "EntitySetName": "new_bankaccounts",
 "IsEnabledForExternalChannels": false,
 "IsPrivate": false,
 "MetadataId": "417129e1-207c-e511-80d2-00155d2a68d2",
 "HasChanged": null
}

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0

Kenmerken maken

U kunt kenmerken maken terwijl u de entiteit maakt door de JSON-definitie van de kenmerken in de Attributes-matrix op te nemen voor de entiteit die u plaatst samen met het tekenreekskenmerk dat fungeert als het primaire-naamkenmerk. Wanneer u kenmerken wilt toevoegen aan een entiteit die al is gemaakt, kunt u een POST-aanvraag verzenden met de JSON-definitie hiervan naar de collection-valued navigatie-eigenschap van de entiteit Attributes.

Een tekenreekskenmerk maken

In het volgende voorbeeld worden deze eigenschappen gebruikt voor het maken van een tekenreekskenmerk.

Eigenschappen van tekenreekskenmerk	Waarden
SchemaName	new_BankName
DisplayName	Banknaam
Description	Typ de naam van de bank.
RequiredLevel	None
MaxLength	100
FormatName	Text

In het volgende voorbeeld wordt een tekenreekskenmerk gemaakt met de eigenschappen en toegevoegd aan de entiteit met een MetadataId-waarde van 402fa40f-287c-e511-80d2-00155d2a68d2. De URI voor het kenmerk wordt geretourneerd in de respons.

Aanvraag

POST cc_WebAPI_ServiceURI/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "AttributeType": "String",
 "AttributeTypeName": {
  "Value": "StringType"
 },
 "Description": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Type the name of the bank",
    "LanguageCode": 1033
   }
  ]
 },
 "DisplayName": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Bank Name",
    "LanguageCode": 1033
   }
  ]
 },
 "RequiredLevel": {
  "Value": "None",
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
 },
 "SchemaName": "new_BankName",
 "@odata.type": "Microsoft.Dynamics.CRM.StringAttributeMetadata",
 "FormatName": {
  "Value": "Text"
 },
 "MaxLength": 100
}

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: cc_WebAPI_ServiceURI/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes(f01bef16-287c-e511-80d2-00155d2a68d2)

Een geldkenmerk maken

In het volgende voorbeeld worden deze eigenschappen gebruikt voor het maken van een geldkenmerk.

Eigenschappen van geldkenmerk	Waarden
SchemaName	new_Balance
DisplayName	Saldo
Description	Voer het saldobedrag in.
RequiredLevel	None
PrecisionSource	2 Notitie Voor informatie over de geldige waarden voor PrecisionSource raadpleegt u Kenmerken van hoeveelheidsgegevens. De waarde 2 betekent dat het niveau van decimale precisie overeenkomt met de TransactionCurrency.CurrencyPrecision die is gekoppeld aan de huidige record.

In het volgende voorbeeld wordt een geldkenmerk gemaakt met de eigenschappen en toegevoegd aan de entiteit met een MetadataId-waarde van 402fa40f-287c-e511-80d2-00155d2a68d2. De URI voor het kenmerk wordt geretourneerd in de respons.

Aanvraag

POST cc_WebAPI_ServiceURI/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "AttributeType": "Money",
 "AttributeTypeName": {
  "Value": "MoneyType"
 },
 "Description": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Enter the balance amount",
    "LanguageCode": 1033
   }
  ]
 },
 "DisplayName": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Balance",
    "LanguageCode": 1033
   }
  ]
 },
 "RequiredLevel": {
  "Value": "None",
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
 },
 "SchemaName": "new_Balance",
 "@odata.type": "Microsoft.Dynamics.CRM.MoneyAttributeMetadata",
 "PrecisionSource": 2
}

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: cc_WebAPI_ServiceURI/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes(f11bef16-287c-e511-80d2-00155d2a68d2)

Een datum/tijd-kenmerk maken

In het volgende voorbeeld worden deze eigenschappen gebruikt voor het maken van een datum/tijd-kenmerk.

Eigenschappen van datum/tijd-kenmerk	Waarden
SchemaName	new_Checkeddate
DisplayName	Datum
Description	De datum waarop het rekeningsaldo voor het laatst is bevestigd.
RequiredLevel	Geen
Format	DateOnly Notitie Voor de geldige opties voor deze eigenschap, raadpleegt u DateTimeFormat EnumType.

In het volgende voorbeeld wordt een datum/tijd-kenmerk gemaakt met de eigenschappen en toegevoegd aan de entiteit met een MetadataId-waarde van 402fa40f-287c-e511-80d2-00155d2a68d2. De URI voor het kenmerk wordt geretourneerd in de respons.

Aanvraag

POST cc_WebAPI_ServiceURI/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "AttributeType": "DateTime",
 "AttributeTypeName": {
  "Value": "DateTimeType"
 },
 "Description": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "The date the account balance was last confirmed",
    "LanguageCode": 1033
   }
  ]
 },
 "DisplayName": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Date",
    "LanguageCode": 1033
   }
  ]
 },
 "RequiredLevel": {
  "Value": "None",
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
 },
 "SchemaName": "new_Checkeddate",
 "@odata.type": "Microsoft.Dynamics.CRM.DateTimeAttributeMetadata",
 "Format": "DateOnly"
}

Respons

HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: cc_WebAPI_ServiceURI/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes(fe1bef16-287c-e511-80d2-00155d2a68d2)

Een klantopzoekkenmerk maken

In tegenstelling tot andere kenmerken wordt een klantopzoekkenmerk gemaakt met de actie CreateCustomerRelationships. De parameters voor deze actie vereisen dat het opzoekkenmerk en een paar een-op-veel-relaties worden gedefinieerd. Een klantopzoekkenmerk heeft twee een-op-veel-relaties: één naar de entiteit account en de andere naar entiteit contactpersoon.

In het volgende voorbeeld wordt met deze eigenschappen een klantopzoekkenmerk aangemaakt.

Eigenschappen klantopzoekkenmerk	Waarden
SchemaName	new_CustomerId
DisplayName	Klant
Description	Voorbeeld van klantopzoekkenmerk

In het voorbeeld wordt een klantopzoekkenmerk new_CustomerId aangemaakt en toegevoegd aan de aangepaste entiteit new_bankaccount. De respons is een complex type CreateCustomerRelationshipsResponse.

Request

POST 
      [Organization URI]/api/data/v8.2/CreateCustomerRelationships HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json
Content-Type: application/json; charset=utf-8

{
    "OneToManyRelationships": [{
        "SchemaName": "new_bankaccount_customer_account",
        "ReferencedEntity": "account",
        "ReferencingEntity": "new_bankaccount"
    }, {
        "SchemaName": "new_bankaccount_customer_contact",
        "ReferencedEntity": "contact",
        "ReferencingEntity": "new_bankaccount"
    }],
    "Lookup": {
        "AttributeType": "Lookup",
        "AttributeTypeName": {
            "Value": "LookupType"
        },
        "Description": {
            "@odata.type": "Microsoft.Dynamics.CRM.Label",
            "LocalizedLabels": [{
                "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
                "Label": "Sample Customer Lookup Attribute",
                "LanguageCode": 1033
            }],
            "UserLocalizedLabel": {
                "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
                "Label": "Sample Customer Lookup Attribute",
                "LanguageCode": 1033
            }
        },
        "DisplayName": {
            "@odata.type": "Microsoft.Dynamics.CRM.Label",
            "LocalizedLabels": [{
                "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
                "Label": "Customer",
                "LanguageCode": 1033
            }],
            "UserLocalizedLabel": {
                "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
                "Label": "Customer",
                "LanguageCode": 1033
            }
        },
        "SchemaName": "new_CustomerId",
        "@odata.type": "Microsoft.Dynamics.CRM.ComplexLookupAttributeMetadata"
    }
}

Response

HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
    "@odata.context": "
      [Organization URI]/api/data/v8.2/$metadata#Microsoft.Dynamics.CRM.CreateCustomerRelationshipsResponse",
    "RelationshipIds": [
        "a7d261bc-3580-e611-80d7-00155d2a68de", "aed261bc-3580-e611-80d7-00155d2a68de"
    ],
    "AttributeId": "39a5d94c-e8a2-4a41-acc0-8487242d455e"
}

Een kenmerk bijwerken

Zoals eerder aangegeven in Entiteiten bijwerken, worden modelentiteiten bijgewerkt met de methode HTTP PUT met de volledige JSON-definitie van het huidige item. Dit geldt voor zowel kenmerken als entiteiten. Net als met entiteiten, hebt u de mogelijkheid om labels te overschrijven met behulp van de MSCRM.MergeLabels-koptekst met de waarde ingesteld op false en moet u aanpassingen publiceren voordat deze actief worden in het systeem.

Zie ook

De web-API gebruiken met Dynamics 365-metagegevens
Query's uitvoeren op metagegevens via de web-API
Metagegevens ophalen op naam of MetadataId
Entiteitsrelaties maken en bijwerken met behulp van de web-API
De organisatieservice met Dynamics 365-metagegevens gebruiken
Metagegevens van entiteitskenmerken aanpassen

Microsoft Dynamics 365

Delen via

Entiteitsdefinities maken en bijwerken met behulp van de web-API

In dit onderwerp

Entiteiten maken

Entiteiten bijwerken

Kenmerken maken

Een tekenreekskenmerk maken

Een geldkenmerk maken

Een datum/tijd-kenmerk maken

Een klantopzoekkenmerk maken

Een kenmerk bijwerken

Zie ook

Aanvullende resources