Del via

Introduktion til objektattributter i Microsoft Dynamics 365

  • Artikel

 

Udgivet: januar 2017

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

Objekter indeholder et sæt attributter, der repræsenterer de data, der kan inkluderes i hver post. Udviklere skal forstå de forskellige typer attributter, og skal kunne arbejde med dem. Metadataene for attributter beskriver de gyldige handlinger og funktionsmåder for forskellige typer attributter. Mange typer attributter kan grupperes efter almindelige funktionsmåder.

Den specifikke oplevelse, udviklerne får, afhænger af deres udviklingsformat.Flere oplysninger:0fcf59aa-d564-4c9b-9042-40df8664f831#entity_programming.

Bemærk

Dette emne indeholder referencer til mange metadataegenskaber.Du kan få vist objektmetadataene for din virksomhed ved at installere Metadata-browserløsningen, der er beskrevet i Gennemse metadata for organisationen. Du kan også få vist metadataene for en ikke-tilpasset virksomhed i Excel-filen kaldet EntityMetadata.xlsx, der findes i den øverste mappe i SDK download.

Dette emne indeholder

Gyldige handlinger på attributter

Typer attributter

Dataattributter for kategorisering

Dataattributter for samling

Dataattributter for dato og klokkeslæt

Dataattributter for billede

Dataattributter for antal

Dataattributter for reference

Dataattributter for streng

Dataattributter for entydigt id

Virtuelle attributter

Logiske attributter

Gyldige handlinger på attributter

Hver attribut har metadata, der beskriver de handlinger, som den understøtter. Du skal være opmærksom på de handlinger, der gælder for de attributter, du arbejder med.

Egenskaben AttributeMetadata

Beskrivelse

IsValidForCreate

Sand, hvis denne attributværdi er gyldig til at blive angivet, når der oprettes en post, ellers falsk.

IsValidForRead

Sand, hvis denne attributværdi kan hentes, ellers falsk.

IsValidForUpdate

Sand, hvis denne attributværdi er gyldig til at blive opdateret, når der oprettes en post, ellers falsk.

Typer attributter

Attributter er angivet i metadataene, og egenskaben AttributeMetadata.AttributeTypeName indeholder den værdi, der beskriver typen. De statiske AttributeTypeDisplayName-medlemmer giver en liste over mulige typer.

Bemærk

Den ældre egenskab AttributeType indeholder data, der overvejende er justeret i forhold til AttributeTypeName, bortset fra at den viser ImageType-attributter såsom Virtual. Du skal bruge egenskaben AttributeTypeName i stedet for egenskaben AttributeType.

I følgende afsnit grupperes attributtyperne i følgende kategorier, så du lettere kan sammenligne dem:

  • Dataattributter for kategorisering

  • Dataattributter for samling

  • Dataattributter for dato og klokkeslæt

  • Dataattributter for billede

  • Dataattributter for antal

  • Dataattributter for reference

  • Dataattributter for streng

  • Dataattributter for entydigt id

  • Virtuelle attributter

Dataattributter for kategorisering

Hver af de fem attributter i denne gruppe nedarver fra en fælles EnumAttributeMetadata-basisklasse og anvender et foruddefineret sæt af gyldige værdier til at gruppere poster i kategorier.

Angiv valgliste-, status- og tilstandsattributter ved hjælp af en OptionSetValue med en Value-egenskab indstillet til et heltal, der repræsenterer en gyldig indstilling i metadataene.

Angiv booleske attributter ved hjælp af en boolesk værdi, men vær opmærksom på, at dette er en kategorisering, der er begrænset til blot to indstillinger.

EntityName-attributter anvender en strengværdi, der er begrænset til at være et logisk navn på et objekt i organisationen.

Brugerdefinerede valglisteattributter og booleske attributter kan angives som beregnede attributter.Flere oplysninger:26ada6f7-3e22-465c-90f8-19d326785eb4#BKMK_Calculated.

Metadatatype

Værdien AttributeTypeName

Beskrivelse

PicklistAttributeMetadata

PicklistType

Gyldige værdier angives i OptionMetadata.Value for den attribut, der er defineret i OptionSetMetadata.Options.

I tilpasningsværktøjerne i programmet kaldes disse attributter felter med grupperede indstillinger.

StatusAttributeMetadata

StatusType

Disse systemattributter navngives generelt StatusCode. Gyldige værdier angives i StatusOptionMetadata.Value for den attribut, der er defineret i OptionSetMetadata.Options.

Egenskaben StatusOptionMetadata.State for hver indstilling beskriver den gyldige værdi for den tilsvarende StateCode-værdi. Før du angiver StatusCode, skal du kontrollere, at den er gyldig for den aktuelle StateCode-værdi. Brug meddelelsen SetStateRequest til at angive attributværdierne StatusCode og StateCode, når du skal ændre tilstanden for posten.

Disse attributter kan have yderligere begrænsninger, som der kan angives værdier for. Egenskaben StatusOptionMetadata.TransitionData kan indeholde oplysninger om, hvilke indstillinger der er tilladt, når værdien EntityMetadata.EnforceTransitions er sand.Flere oplysninger:Definere brugerdefinerede overgange af tilstandsmodeller.

StateAttributeMetadata

StateType

Disse systemattributter navngives generelt StatusCode. Gyldige værdier angives i StateOptionMetadata.Value for den attribut, der er defineret i OptionSetMetadata.Options.

StateCode er ikke gyldig til opdatering. Når posten er blevet oprettet, kan StateCode kun angives ved hjælp af meddelelsen SetStateRequest.

Egenskaben StateOptionMetadata.DefaultStatus for hver indstilling beskriver den standard-StatusCode, der vil blive brugt, hvis den ikke angives som en parameter i SetStateRequest.

BooleanAttributeMetadata

BooleanType

Booleske attributter kan angives direkte ved hjælp af en boolesk værdi, men ligesom de andre har de også en OptionSet-egenskab med egenskaberne FalseOption og TrueOption, der svarer til de booleske indstillinger. Hver af disse egenskaber definerer et sæt oversatte etiketter, der repræsenterer, hvad sand og falsk betyder for attributten. I tilpasningsværktøjerne i programmet kaldes disse attributter To indstillinger-felter, da betydningen for hver indstilling kan være ethvert sæt af indstillinger, der udelukker hinanden, ikke blot sand og falsk. Indstillingerne kan f.eks. være stor og lille.

EntityNameAttributeMetadata

EntityNameType

Disse systemattributter er generelt knyttet til et entydigt id eller en referenceattribut, der gælder for flere typer. Værdien af denne attribut er en strengværdi, der repræsenterer det logiske navn på et objekt. Hvis den tilsvarende referenceattribut er en EntityReference, er værdien af denne attribut den samme som værdien for egenskaben EntityReference.Name.

Dataattributter for samling

Disse systemattributter returnerer samlinger af værdier.

Værdien AttributeTypeName

Beskrivelse

CalendarRulesType

Der er ingen faktiske attributter, der anvender CalendarRulesType. Hvis du bruger tidlig binding, opretter værktøjet til oprettelse af kode de følgende to simulerede attributter, der ikke findes i metadataene. Disse attributter repræsenterer faktisk en visning af de kalenderregelposter, der er tilknyttet i en en til mange-relation til objektforekomsten.

  • Calendar.CalendarRules-relation: calendar_calendar_rules

  • Service.CalendarRules-relation: service_calendar_rules

PartyListType

Følgende attributter giver mulighed for at angive flere EntityReference for forskellige typer aktiviteter.

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

Dataattributter for dato og klokkeslæt

Attributter med AttributeTypeName-metadataværdien DateTimeType. Angiv disse attributter ved hjælp af System.DateTime.

Egenskaben DateTimeAttributeMetadata.Format kan være en af følgende DateTimeFormat-værdier:

  • DateAndTime: Vis dato og klokkeslæt.

  • DateOnly: Vis kun dato

Brugerdefinerede attributter for dato og klokkeslæt kan angives som beregnede attributter eller akkumuleringsattributter.Flere oplysninger:Beregnede attributter og akkumuleringsattributter.

Dataattributter for billede

For de objekter, som understøtter billedattributter, er SchemaName for objektbilledattributten altid EntityImage.

Flere oplysninger:Billedattributter., 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages og Eksempel: Angive og hente objektbilleder.

Dataattributter for antal

Attributter i denne kategori anvender numeriske data. Hver af disse attributter har en MaxValue- og MinValue-metadataegenskab til angivelse af en række gyldige værdier.

Brugerdefinerede decimal-, heltal- og pengeattributter kan angives som beregnede attributter eller akkumuleringsattributter.Flere oplysninger:Beregnede attributter og akkumuleringsattributter.

Metadatatype

Værdien AttributeTypeName

Beskrivelse

BigIntAttributeMetadata

BigIntType

BigInt-attributter er kun til intern brug.

DecimalAttributeMetadata

DecimalType

Brug decimal-værdier.

Metadataegenskaben Precision angiver den præcision, der skal bruges for attributten.

DoubleAttributeMetadata

DoubleType

Brug dobbelte værdier.

Metadataegenskaben Precision angiver den præcision, der skal bruges for attributten.

IntegerAttributeMetadata

IntegerType

Brug heltal-værdier.

MoneyAttributeMetadata

MoneyType

Brug Money, som har en decimalValue-egenskab.

Hver pengeattribut har en tilsvarende systemberegnet grundvaluta-pengeattribut, der bruges til at beregne værdien i organisationens grundvaluta, når flere valutaer er blevet aktiveret for organisationen. Egenskaben IsBaseCurrency angiver, om en pengeattribut repræsenterer grundvalutaen.Flere oplysninger:Transaktionsvalutaobjekt (valuta).

Pengeattributter har også en metadataegenskab PrecisionSource, der kan angive det præcisionsniveau, der skal bruges. Heltalværdien i denne egenskab angiver, om:

  • 0: Præcisionen bestemmes af metadataegenskaben Precision.

  • 1: Værdien Organization.PricingDecimalPrecision.

  • 2: Den TransactionCurrency.CurrencyPrecision, der er tilknyttet til den aktuelle post.

Dataattributter for reference

Disse attributter kaldes normalt opslagsattributter, og hver af dem indeholder en EntityReference-værdi. Forskellen mellem disse attributter er, hvilke typer objekter de kan tilknyttes til. Metadataegenskaben Targets indeholder en String[] med de gyldige logiske navne på objekter, der repræsenterer gyldige mål for opslaget. Brugerdefinerede opslagsattributter kan kun have en enkelt type i egenskaben Targets.

PartyListType repræsenterer også en slags referencedataattribut, men da de indeholder en samling af referencer, er de medtaget i Dataattributter for samling.

Metadatatype

Værdien AttributeTypeName

Beskrivelse

LookupAttributeMetadata

CustomerType

Disse systemopslagsattributter kan knyttes til firma- eller kontaktobjektposter.

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

Disse opslagsattributter kan bruges til at angive referencer til en post af den type, der er angivet af metadataegenskaben .

Nogle systemopslag har ikke en værdi angivet for egenskaben Targets, men det ønskede objekt være synligt baseret på den objektrelation, der er knyttet til opslaget.

OwnerType

Disse systemopslag er altid navngivet OwnerId, og hver brugerejet objekt har et. De kan henvise til enten SystemUser- eller Team-poster.

Dataattributter for streng

Der er to typer attributter, der bruger strengdata.

Metadatatype

Værdien AttributeTypeName

Beskrivelse

StringAttributeMetadata

StringType

En attribut til en strengværdi, for hvilken der kan anvendes et format.Flere oplysninger:89969adc-8577-424c-bfcc-7f65c5d4bd19#BKMK_StringAttributeMetadataFormats.

Brugerdefinerede strengattributter kan angives som beregnede attributter.Flere oplysninger:26ada6f7-3e22-465c-90f8-19d326785eb4#BKMK_Calculated.

MemoAttributeMetadata

MemoType

En attribut for en strengværdi, der er beregnet til noter. Disse attributter svarer til strengattributter med værdien af egenskaben FormatName indstillet til TextArea.

Dataattributter for entydigt id

Attributter med AttributeTypeName-metadataværdien UniqueidentifierType indeholder System.Guid-værdier, som kan være nul.

Hver objektforekomst indeholder en attribut, der repræsenterer det entydige id for posten. Denne attribut har et skemanavn, som følger navngivningskonventionen <objektskemanavn> + id. For objektet Firma hedder skemanavnet for attributten, der repræsenterer det entydige id, f.eks. AccountId. Denne værdi er også tilgængelig direkte ved hjælp af egenskaben Entity.Id. Denne attribut returneres altid, når du henter et objekt, selvom du ikke medtager den ColumnSet for en forespørgsel. Denne værdi er null for et nyligt instantieret objekt. Det er gyldigt til at indstille en Guid-værdi for at angive et entydigt id, når du opretter en ny post, men for at opnå den bedste ydelse anbefaler vi, at du lader værdien være null og lader systemet tildele en værdi, når posten oprettes. Når en post gemmes, bliver denne værdi skrivebeskyttet.

Objekter kan omfatte andre entydigt id-attributter afhængigt af objektets funktioner. Objekter, der er aktiveret til forretningsprocesser indeholder f.eks entydigt id-attributter for ProcessId og StageId til at spore den aktuelle forretningsproces, der er tilknyttet posten. Visse systemrelationer, som normalt muligvis ville bruge en EntityReference-værdi, bruger i stedet et entydigt id. Objekterne Firma og Kontakt har f.eks. hver to attributter for entydigt id (Address1_AddressId og Address2_AddressId), som svarer til CustomerAddress-poster, der oprettes, når der oprettes et firma eller en kontakt.

Virtuelle attributter

Metadata for et objekt indeholder nogle attributter med AttributeTypeName-metadataværdien VirtualType. Disse attributter kan ikke bruges i kode.

Logiske attributter

Logiske attributter indeholder værdier, der er gemt i forskellige databasetabeller end andre attributter i objektet. I de fleste tilfælde er denne interne implementering ikke relevant for at arbejde med Microsoft Dynamics 365. Når du bruger logiske attributter som kilder til et beregnet felt, kan værdierne i det beregnede felt ikke sorteres. Brug egenskaben AttributeMetadata.IsLogical til at registrere, om en attribut er en logisk attribut.

De mest almindelige logiske attributter er dem, der kan gemme adresseoplysninger i flere særlige objekter: CompetitorAddress, CustomerAddress, InternalAddress, LeadAddress og PublisherAddress. Der er 8 systemobjekter, som omfatter et komplet sæt af attributter for to adresser ved hjælp af logiske attributter. Hver af disse attributter begynder med "Adresse *", f.eks. Address1_City eller Address2_Latitude.

Se også

Introduktion til objekter i Microsoft Dynamics 365
Billedattributter.
Beregnede attributter og akkumuleringsattributter
Eksempel: Hente gyldige statusovergange
Eksempel: Angive og hente objektbilleder

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret