Inleiding in entiteitskenmerken in Microsoft Dynamics CRM 2015

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

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 ontwikkelingsstijl waarvoor zij kiezen.Meer informatie:Entiteitprogrammering (eerder gebonden, later gebonden en uitbreidingen voor ontwikkelaars).

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
IsValidForCreate	Waar als deze kenmerkwaarde geldig is en kan worden ingesteld als een record wordt gemaakt, anders onwaar.
IsValidForRead	Waar als deze kenmerkwaarde kan worden opgehaald, anders onwaar.
IsValidForUpdate	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:Berekende kenmerken.

Type metagegevens	AttributeTypeName Waarde	Beschrijving
PicklistAttributeMetadata	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.
StatusAttributeMetadata	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.
StateAttributeMetadata	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.
BooleanAttributeMetadata	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.
EntityNameAttributeMetadata	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. Relatie Calendar.CalendarRules: calendar_calendar_rules Relatie Service.CalendarRules: service_calendar_rules
PartyListType	De volgende kenmerken staan het instellen van meerdere EntityReference voor diverse typen activiteiten toe. ActivityPointer.allparties Appointment.OptionalAttendees Appointment.Organizer Appointment.requiredattendees CampaignActivity.from CampaignActivity.Partners CampaignResponse.Customer CampaignResponse.from CampaignResponse.Partner Email.bcc Email.cc Email.from Email.to Fax.from Fax.to Letter.bcc Letter.cc Letter.from Letter.to PhoneCall.from PhoneCall.to RecurringAppointmentMaster.OptionalAttendees RecurringAppointmentMaster.Organizer RecurringAppointmentMaster.RequiredAttendees ServiceAppointment.Customers ServiceAppointment.Resources SocialActivity.From SocialActivity.Resources SocialActivity.To

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, Entiteitsafbeeldingen 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
BigIntAttributeMetadata	BigIntType	BigInt-kenmerken zijn alleen voor intern gebruik.
DecimalAttributeMetadata	DecimalType	Gebruik decimale waarden. De metagegevenseigenschap Precision stelt de precisie in die voor het kenmerk moet worden gebruikt.
DoubleAttributeMetadata	DoubleType	Gebruik dubbele waarden. De metagegevenseigenschap Precision stelt de precisie in die voor het kenmerk moet worden gebruikt.
IntegerAttributeMetadata	IntegerType	Gebruik int-waarden.
MoneyAttributeMetadata	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: 0: De precisie wordt bepaald door de metagegevenseigenschap Precision. 1: De waarde Organization.PricingDecimalPrecision. 2: De TransactionCurrency.CurrencyPrecision die is gekoppeld aan de huidige record.

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.

Type metagegevens	AttributeTypeName Value	Beschrijving
LookupAttributeMetadata	CustomerType	Deze systeemopzoekkenmerken kunnen aan Account- of Contactpersoon-entiteitsrecords worden gekoppeld. Contact.ParentCustomerId Contract.BillingCustomerId Contract.CustomerId ContractDetail.CustomerId CustomerOpportunityRole.CustomerId CustomerRelationship.CustomerId CustomerRelationship.PartnerId Entitlement.CustomerId Incident.CustomerId Invoice.CustomerId Lead.CustomerId Opportunity.CustomerId Quote.CustomerId SalesOrder.CustomerId SocialActivity.PostAuthor SocialActivity.PostAuthorAccount SocialProfile.CustomerId
	LookupType	Deze opzoekkenmerken kunnen worden gebruikt om verwijzingen in te stellen naar een record van het type dat wordt aangegeven door de metagegevenseigenschap . Sommige systeemopzoekbewerkingen hebben geen waarde ingesteld voor de eigenschap Targets, maar de beoogde entiteit moet duidelijk zijn op basis van de entiteitsrelatie die aan de opzoekbewerking is gekoppeld.
	OwnerType	Deze systeemopzoekbewerkingen worden altijd OwnerId genoemd en elke entiteit die eigendom van de gebruiker is heeft er één. Zij kunnen verwijzen naar SystemUser- of Team-records.

Kenmerken voor tekenreeksgegevens

Er zijn twee typen kenmerken die tekenreeksgegevens gebruiken.

Type metagegevens	AttributeTypeName Value	Beschrijving
StringAttributeMetadata	StringType	Een kenmerk voor een tekenreekswaarde waarop een indeling kan worden toegepast.Meer informatie:StringAttributeMetadata-indelingen. Kenmerken Aangepaste tekenreeks kunnen worden gedefinieerd als berekende kenmerken.Meer informatie:Berekende kenmerken.
MemoAttributeMetadata	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 CRM. 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 CRM 2015
Afbeeldingskenmerken
Berekende en samengetelde kenmerken
Voorbeeld: geldige statusovergangen ophalen
Voorbeeld: Entiteitsafbeeldingen instellen en ophalen

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht