Inleiding in entiteitskenmerken in Microsoft Dynamics 365
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Entiteiten omvatten een set kenmerken die de gegevens vertegenwoordigen die in elke record kunnen worden opgenomen. Ontwikkelaars moeten de verschillende typen kenmerken begrijpen en moeten weten hoe zij hiermee kunnen werken. De metagegevens voor kenmerken beschrijven de geldige bewerkingen en gedragingen van verschillende typen kenmerken. Verschillende typen kenmerken kunnen worden gegroepeerd op basis van algemene gedragingen.
De specifieke ervaring van ontwikkelaars is afhankelijk van hun ontwikkelingsstijl.Meer informatie:0fcf59aa-d564-4c9b-9042-40df8664f831#entity_programming.
Notitie
Dit onderwerp bevat verwijzingen naar vele metagegevenseigenschappen.Als u de metagegevens van de entiteit voor uw organisatie wilt bekijken, installeert u de oplossing Metadata Browser die wordt beschreven in Blader door de metagegevens voor uw organisatie. U kunt ook metagegevens weergeven voor een niet-aangepaste organisatie in het Excel-bestand EntityMetadata.xlsx, in de bovenste map van SDK download.
In dit onderwerp
Geldige bewerkingen op kenmerken
Typen kenmerken
Kenmerken voor het categoriseren van gegevens
Kenmerken van verzamelingsgegevens
Kenmerk voor datum- en tijdgegevens
Kenmerken voor afbeeldingsgegevens
Kenmerken van hoeveelheidsgegevens
Kenmerken voor referentiegegevens
Kenmerken voor tekenreeksgegevens
Unieke id van gegevenskenmerken
Virtuele kenmerken
Logische kenmerken
Geldige bewerkingen op kenmerken
Elk kenmerk heeft metagegevens die de ondersteunde bewerkingen beschrijven. U moet op de hoogte zijn van de bewerkingen die geldig zijn voor de kenmerken waarmee u werkt.
Eigenschap AttributeMetadata |
Beschrijving |
|---|---|
Waar als deze kenmerkwaarde geldig is en kan worden ingesteld als een record wordt gemaakt, anders onwaar. |
|
Waar als deze kenmerkwaarde kan worden opgehaald, anders onwaar. |
|
Waar als deze kenmerkwaarde geldig is en kan worden ingesteld als een record wordt bijgewerkt, anders onwaar. |
Typen kenmerken
Kenmerken worden gedefinieerd in metagegevens en de eigenschap AttributeMetadata.AttributeTypeName bevat de waarde die het type beschrijft. De statische AttributeTypeDisplayName-leden bieden de lijst met mogelijke typen.
Notitie
De oudere eigenschap AttributeType bevat gegevens die meestal zijn afgestemd op AttributeTypeName, behalve dat het kenmerk ImageType wordt weergegeven als Virtual. U moet de eigenschap AttributeTypeName gebruiken in plaats van de eigenschap AttributeType.
In de volgende sectie worden de volgende typen kenmerken gegroepeerd in de volgende categorieën zodat u deze gemakkelijker kunt vergelijken:
Kenmerken voor het categoriseren van gegevens
Kenmerken van verzamelingsgegevens
Kenmerk voor datum- en tijdgegevens
Kenmerken voor afbeeldingsgegevens
Kenmerken van hoeveelheidsgegevens
Kenmerken voor referentiegegevens
Kenmerken voor tekenreeksgegevens
Unieke id van gegevenskenmerken
Virtuele kenmerken
Kenmerken voor het categoriseren van gegevens
Elk van de vijf kenmerken in deze groep neemt eigenschappen van een veelgebruikte basisklasse EnumAttributeMetadata over en gebruikt een vooraf gedefinieerde set met geldige waarden om records te groeperen in categorieën.
De kenmerken Selectielijst, Status en Toestand die gebruikmaken van een OptionSetValue met een eigenschap Value ingesteld op een geheel getal dat een geldige optie binnen de metagegevens vertegenwoordigt.
Stel Boole-kenmerken in met een Boole-waarde, maar onthoud dat dit een categorisatie is die beperkt is tot twee opties.
Kenmerken EntityName gebruiken een tekenreekswaarde die beperkt is tot een geldige logische naam voor entiteiten in de organisatie.
Kenmerken Aangepaste selectielijst en Boole-waarde kunnen worden gedefinieerd als berekende kenmerken.Meer informatie:26ada6f7-3e22-465c-90f8-19d326785eb4#BKMK_Calculated.
Type metagegevens |
AttributeTypeName Waarde |
Beschrijving |
|---|---|---|
PicklistType |
Geldige waarden worden ingesteld in de OptionMetadata.Value voor dit kenmerk dat wordt gedefinieerd binnen de OptionSetMetadata.Options. Binnen de aanpassingshulpmiddelen in de toepassing worden deze kenmerken velden Optieset genoemd. |
|
StatusType |
Deze systeemkenmerken worden meestal StatusCode genoemd. Geldige waarden worden ingesteld in de StatusOptionMetadata.Value voor dit kenmerk dat wordt gedefinieerd binnen de OptionSetMetadata.Options. De eigenschap StatusOptionMetadata.State voor elke optie beschrijft de geldige waarde voor de bijbehorende StateCode-waarde. Voordat u de StatusCode instelt, moet u controleren of deze geldig is voor de huidige StateCode-waarde. Gebruik het SetStateRequest-bericht om de kenmerkwaarden StatusCode en StateCode in te stellen als u de status van de record moet wijzigen. Deze kenmerken kunnen verdere beperkingen hebben met betrekking tot de waarden die kunnen worden ingesteld. De eigenschap StatusOptionMetadata.TransitionData kan gegevens bevatten waarvoor opties zijn toegestaan wanneer de waarde EntityMetadata.EnforceTransitions waar is.Meer informatie:Aangepaste statusmodelovergangen definiëren. |
|
StateType |
Deze systeemkenmerken worden meestal StatusCode genoemd. Geldige waarden worden ingesteld in de StateOptionMetadata.Value voor dit kenmerk dat wordt gedefinieerd binnen de OptionSetMetadata.Options. StateCode is niet geldig voor bijwerken. Nadat de record is gemaakt, kan de StateCode alleen worden ingesteld met het bericht SetStateRequest. De eigenschap StateOptionMetadata.DefaultStatus voor elke optie beschrijft de standaard StatusCode die wordt gebruikt als deze niet is ingesteld als parameter in SetStateRequest. |
|
BooleanType |
Boole-kenmerken kunnen direct worden ingesteld met een Boole-waarde, maar net als de anderen, hebben zij eveneens een eigenschap OptionSet met eigenschappen FalseOption en TrueOption die overeenkomen met de Boole-opties. Elk van deze eigenschappen definieert een set gelokaliseerde labels die aangeven wat waar en onwaar betekent voor het kenmerk. Binnen de aanpassingshulpmiddelen in de toepassing worden deze kenmerken velden Twee opties genoemd omdat de betekenis voor elke optie elk elkaar uitsluitend optiepaar kan zijn, niet alleen waar en onwaar. De opties kunnen bijvoorbeeld groot en klein zijn. |
|
EntityNameType |
Deze systeemkenmerken worden meestal gekoppeld aan een unieke id of aan een verwijzingskenmerk dat geldig is voor meerdere typen. De waarde van dit kenmerk is een tekenreekswaarde die de logische naam van een entiteit weergeeft. Als het corresponderende verwijzingskenmerk een EntityReference is, is de waarde van dit kenmerk gelijk aan de waarde van de eigenschap EntityReference.Name. |
Kenmerken van verzamelingsgegevens
Deze systeemkenmerken retourneren verzamelingen waarden.
AttributeTypeName Value |
Beschrijving |
|---|---|
CalendarRulesType |
Er zijn geen kenmerken die gebruikmaken van de CalendarRulesType. Bij gebruik van vroegtijdige binding maakt het hulpprogramma voor de codegeneratie de volgende twee gesimuleerde kenmerken die niet aanwezig zijn in de metagegevens. Deze kenmerken vertegenwoordigen een weergave van de agendaregelrecords die in een een-op-veel relatie aan een entiteitsexemplaar zijn gekoppeld.
|
PartyListType |
De volgende kenmerken staan het instellen van meerdere EntityReference voor diverse typen activiteiten toe. ActivityPointer.allparties |
Kenmerk voor datum- en tijdgegevens
Kenmerken met de metagegevenswaarde AttributeTypeName van DateTimeType. Stel deze kenmerken in met System.DateTime.
De eigenschap DateTimeAttributeMetadata.Format kan een van de volgende waarden DateTimeFormat zijn:
DateAndTime: Geef de datum en tijd weer.
DateOnly: Geef alleen de datum weer
Kenmerken Aangepaste datum en tijd kunnen worden gedefinieerd als berekende of samengetelde kenmerken.Meer informatie:Berekende en samengetelde kenmerken.
Kenmerken voor afbeeldingsgegevens
Voor die entiteiten die afbeeldingskenmerken ondersteunen, is de SchemaName van het entiteitsafbeeldingskenmerk altijd EntityImage.
Meer informatie:Afbeeldingskenmerken, 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages en Voorbeeld: Entiteitsafbeeldingen instellen en ophalen.
Kenmerken van hoeveelheidsgegevens
Kenmerken in deze categorie gebruiken numerieke gegevens. Elk van deze kenmerken heeft een metagegevenseigenschap MaxValue en MinValue om een bereik van geldige waarden in te stellen.
Kenmerken Aangepaste decimaal, Geheel getal en Geld kunnen worden gedefinieerd als berekende of samengetelde kenmerken.Meer informatie:Berekende en samengetelde kenmerken.
Type metagegevens |
AttributeTypeName Value |
Beschrijving |
|---|---|---|
BigIntType |
BigInt-kenmerken zijn alleen voor intern gebruik. |
|
DecimalType |
Gebruik decimale waarden. De metagegevenseigenschap Precision stelt de precisie in die voor het kenmerk moet worden gebruikt. |
|
DoubleType |
Gebruik dubbele waarden. De metagegevenseigenschap Precision stelt de precisie in die voor het kenmerk moet worden gebruikt. |
|
IntegerType |
Gebruik int-waarden. |
|
MoneyType |
Gebruik Money dat een eigenschap decimalValue heeft. Elk kenmerk Geld heeft een corresponderend door het systeem berekende geldkenmerk voor basisvaluta dat wordt gebruikt om de waarde in de basisvaluta van de organisatie te berekenen wanneer er meerdere valuta's voor de organisatie zijn ingeschakeld. De eigenschap IsBaseCurrency bepaalt of een geldkenmerk de basisvaluta aangeeft.Meer informatie:Entiteit Transaction Currency (valuta). Geldkenmerken hebben tevens een metagegegevenseigenschap PrecisionSource die het niveau van precisie kan aangeven dat moet worden gebruikt. De geheel-getalwaarde in deze eigenschap bepaalt of:
|
Kenmerken voor referentiegegevens
Deze kenmerken worden algemeen opzoekkenmerken genoemd en zij kunnen allemaal een waarde EntityReference bevatten. Het verschil tussen deze kenmerken schuilt in de typen entiteiten waaraan zij kunnen worden gekoppeld. De metagegevenseigenschap Targets bevat een String[] van de geldige logische namen voor de entiteit die geldige doelen voor de opzoekbewerking vormen. Aangepaste opzoekkenmerken kunnen slechts één type hebben in de eigenschap Targets.
De PartyListType vertegenwoordigt eveneens een kenmerk voor referentiegegevens, maar faangezien deze een verzameling verwijzingen bevatten, worden deze opgenomen in de Kenmerken van verzamelingsgegevens.
Kenmerken voor tekenreeksgegevens
Er zijn twee typen kenmerken die tekenreeksgegevens gebruiken.
Type metagegevens |
AttributeTypeName Value |
Beschrijving |
|---|---|---|
StringType |
Een kenmerk voor een tekenreekswaarde waarop een indeling kan worden toegepast.Meer informatie:89969adc-8577-424c-bfcc-7f65c5d4bd19#BKMK_StringAttributeMetadataFormats. Kenmerken Aangepaste tekenreeks kunnen worden gedefinieerd als berekende kenmerken.Meer informatie:26ada6f7-3e22-465c-90f8-19d326785eb4#BKMK_Calculated. |
|
MemoType |
Een kenmerk voor een tekenreekswaarde die is bedoeld voor notities. Deze kenmerken zijn vergelijkbaar met tekenreekskenmerken waarbij de waarde van de eigenschap FormatName is ingesteld op TextArea. |
Unieke id van gegevenskenmerken
Kenmerken met een metagegevenswaarde AttributeTypeName van UniqueidentifierType bevatten System.Guid-waarden waarbij null is toegestaan.
Een entiteitsexemplaar bevat één kenmerk dat de unieke id voor de record vertegenwoordigt. Dit kenmerk heeft een schemanaam dat de naamconventie <entiteitsschemanaam>+Id volgt. Zo heeft bijvoorbeeld bij de entiteit Account de schemanaam voor het kenmerk dat het unieke id vertegenwoordigd de naam AccountId. Deze waarde is tevens direct beschikbaar via de eigenschap Entity.Id. Dit kenmerk wordt altijd geretourneerd als u een entiteit ophaalt, zelfs als u het niet opneemt in de ColumnSet van een query. Deze waarde is null voor een nieuw ingestantieerde entiteit. Hoewel het geldig is om een Guid-waarde te stellen om de unieke id te definiëren bij het maken van een nieuwe record, wordt u voor de beste prestaties aangeraden het leeg te laten en het systeem een waarde te laten toewijzen bij het maken van de record. Nadat een record is opgeslagen, wordt deze waarde alleen-lezen.
Entiteiten kunnen andere unieke id-kenmerken hebben afhankelijk van de mogelijkheden van de entiteit. Zo bevatten bijvoorbeeld entiteiten die voor bedrijfsprocessen zijn ingeschakeld unieke id-kenmerken voor ProcessId en StageId om het huidige bedrijfsproces bij te houden dat aan de record is gekoppeld. Bepaalde systeemrelaties die normaliter mogelijk gebruikmaken van een waarde EntityReference, gebruiken in plaats daarvan een unieke id. De entiteiten Account en Contactpersoon hebben bijvoorbeeld elk twee unieke identificatiekenmerken (Address1_AddressId en Address2_AddressId) die corresponderen met CustomerAddress-records die worden gemaakt wanneer een account of contactpersoon wordt gemaakt.
Virtuele kenmerken
De metagegevens voor een entiteit bevat sommige kenmerken met de metagegevenswaarde AttributeTypeName van VirtualType. Deze kenmerken kunnen niet in code worden gebruikt.
Logische kenmerken
Logische kenmerken bevatten waarden die in andere databasetabellen zijn opgeslagen dan andere kenmerken in de entiteit. In de meeste gevallen is deze interne implementatie niet relevant voor het werken met Microsoft Dynamics 365. Wanneer u logische kenmerken gebruikt als bronnen voor een berekend veld, kunnen de waarden in het berekende veld niet worden gesorteerd. Gebruik de eigenschap AttributeMetadata.IsLogical om te detecteren of een kenmerk een logisch kenmerk is.
De meestgebruikte logische kenmerken zijn de kenmerken waarmee adresgegevens in verschillende speciale entiteiten worden opgeslagen: CompetitorAddress, CustomerAddress, InternalAddress, LeadAddress en PublisherAddress. Er zijn 8 systeementiteiten die een volledige reeks van kenmerken voor twee adressen bevatten met logische kenmerken. Elk van deze kenmerken begint met "Address"*, zoals Address1_City of Address2_Latitude.
Zie ook
Inleiding tot entiteiten in Microsoft Dynamics 365
Afbeeldingskenmerken
Berekende en samengetelde kenmerken
Voorbeeld: geldige statusovergangen ophalen
Voorbeeld: Entiteitsafbeeldingen instellen en ophalen
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht