EntitetsmetadataEntity metadata

Varje entitet kan lagra strukturerade data.Each entity provides the capability to store structured data. För utvecklare motsvarar entiteterna de klasser som ska användas vid arbete med data i Common Data Service för appar.For developers, entities correspond to the classes you will use when working with data in Common Data Service for Apps.

EntitetsnamnEntity names

Varje entitet har ett unikt namn som definieras när den skapas.Each entity has a unique name defined when it is created. Det här namnet visas på olika sätt:This name is presented in several ways:

NamnegenskapName Property BeskrivningDescription
SchemaName Vanligtvis en Pascal-version av det logiska namnet.Typically, a Pascal cased version of the logical name. dvs. Kontoi.e. Account
CollectionSchemaName En pluralform av schemanamnet.A plural form of the Schema name. dvs. Kontoni.e. Accounts
LogicalName En gemen version av schemanamnet.All lower-case version of the schema name. dvs. kontoi.e. account
LogicalCollectionName En gemen version av samlingens schemanamn.All lower-case version of the collection schema name. dvs. kontoni.e. accounts
EntitySetName Används för att identifiera samlingar med webb-API:n.Used to identify collections with the Web API. Som standard är det samma som det logiska samlingsnamnet.By default, it is the same as the logical collection name.
Det går att ändra namnet på entitetsuppsättningen genom att uppdatera metadatan programmatiskt.It is possible to change the Entity Set name by programmatically updating the metadata. Men detta bör endast göras innan någon kod i webb-API:n skrivs för entiteten.But this should only be done before any Web API code is written for the entity. Mer information: Utvecklarguide till Dynamics 365 för kundengagemang: Typer och åtgärder för webb-API:n > Byta namn på en entitetsuppsättningMore information: Dynamics 365 Customer Engagement Developer Guide: Web API types and operations > Change the name of an entity set

Anteckning

När du skapar en anpassad entitet kommer det namn som du väljer att föregås av ett anpassningsprefix för utgivaren som är associerad med den lösning som entiteten skapades i.When you create a custom entity, the name you choose will be prepended with the customization prefix value of the solution publisher associated with the solution that the entity was created within. Förutom entitetsuppsättningens namn kan du inte ändra namnen på en entitet när den har skapats.Other than the entity set name, you cannot change the names of an entity after it is created. Om du vill ha konsekventa namn för metadataobjekt i din lösning, kan du skapa dem i kontexten för en lösning som är kopplad till en utgivare med det anpassningsprefix som du vill använda.If you want consistent names for metadata items in your solution, you should create them in the context of a solution you create associated with a solution publisher that contains the customization prefix you want to use. Mer information: Skapa en lösningsutgivare och en lösningMore information : Create a solution publisher and solution

Varje entitet har också tre egenskaper som kan visa lokaliserade värden:Each entity also has three properties that can display localized values:

NamnName BeskrivningDescription
DisplayName Vanligtvis samma som schemanamnet, men kan innehålla blanksteg.Typically, the same as the schema name, but can include spaces. dvs. Kontoi.e. Account
DisplayCollectionName En pluralform av visningsnamnet.A plural form of the Display name. dvs. Kontoni.e. Accounts
Description En kort mening som beskriver entiteten, dvs. Företag som representerar en kund eller en potentiell kund. Det företag som faktureras i affärstransaktioner.A short sentence describing the entity i.e. Business that represents a customer or potential customer. The company that is billed in business transactions.

Detta är de lokaliserbara värden som används för att referera till entiteter i en app.These are the localizable values that are used to refer to the entities in an app. Dessa värden kan ändras när som helst.These values can be changed at any time. Läs mer om att lägga till eller redigera lokaliserade värden i Anpassningsguide för Dynamics 365: Översätta anpassad entitets- och fälttext till andra språk.To add or edit localized values see Dynamics 365 Customization Guide: Translate customized entity and field text into other languages.

PrimärnyckelPrimary key

PrimaryIdAttribute-egenskapens värde är det logiska namnet för attributet som är primärnyckel för entiteten.The PrimaryIdAttribute property value is the logical name of the attribute that is the primary key for the entity.

Som standard har alla entiteter ett enda GUID-attribut (globalt unik identifierare).By default, all entities have a single GUID unique identifier attribute. Detta har vanligen namnet < logiskt entitetsnamn >+ Id.This is usually named < entity logical name >+ Id.

Primärt namnPrimary name

PrimaryNameAttribute-egenskapens värde är det logiska namnet för det attribut som lagrar strängvärdet som identifierar entitetsposten.The PrimaryNameAttribute property value is the logical name of the attribute that stores the string value that identifies the entity record. Detta är värdet som visas i den länk som öppnar posten i ett användargränssnitt.This is the value that will be displayed in a link to open the record in a UI.

Exempel: Kontaktentiteten använder fullname-attributet som primärt namnattribut.Example: The Contact entity uses the fullname attribute as the primary name attribute.

Anteckning

Vissa entiteter har inte något primärt namn.Not every entity will have a primary name. Vissa entiteter är inte avsedda att visas i något användargränssnitt.Some entities are not intended to be displayed in a UI.

EntitetsbilderEntity images

PrimaryImageAttribute-egenskapens värde är det logiska namnet för attributet som lagrar bilddata för entitetsposten.The PrimaryImageAttribute property value is the logical name of the attribute that stores the image data for the entity record. Varje entitet kan bara ha ett bildattribut och det logiska namnet på attributet är alltid entityimage.Each entity can have only one image attribute and the logical name of that attribute is always entityimage.

Exempel: Kontaktentitetens attribut EntityImage kan lagra en bild av kontakten.Example: The Contact Entity EntityImage attribute can store a picture of the contact.

Av prestandaskäl ingår entitetsbilder inte i hämtningsåtgärder, såvida det inte uttryckligen begärs.For performance reasons, entity images are not included in retrieve operations unless explicitly requested.

Varje entitet som har stöd för entitetsbilder har tre stödjande attribut.Each entity that supports entity images will have three supporting attributes.

SchemaNameSchemaName TypType BeskrivningDescription
EntityImage_Timestamp BigIntType Värdet motsvarar när bilden senast uppdaterades och används för att säkerställa att den senaste bildversionen hämtas och cachelagras på klienten.The value represents when the image was last updated and is used to help make sure that the latest version of the image is downloaded and cached on the client.
EntityImage_URL StringType En absolut URL för att visa entitetsbilden i en klient.An absolute URL to display the entity image in a client.
EntityImageId UniqueIdentifierType Bildens unika identifierareThe unique identifier of the image

Mer information:More information:

Anteckning

Detta skiljer sig från den ikon som visas för en entitet i modelldrivna appar.This is different from the icon displayed for an entity in model-driven apps. IconVectorName-egenskapen innehåller namnet på SVG-webbresursen som anger detta.The IconVectorName property contains the name of the SVG web resource that sets this.

EntitetstyperTypes of entities

Funktioner och beteenden för entiteter beror på flera entitetsegenskaper.The capabilities and behavior of entities depends on several entity properties. De flesta av de här egenskaperna är relativt enkla och har beskrivande namn.Most of these properties are relatively simple and have descriptive names. Fyra som kräver vissa ytterligare förklaring är: Ägarskap, Aktivitetsentiteter, ActivityParty-entitet och Underordnade entiteter.Four that require some additional explanation are: Ownership, Activity entities, Activityparty entity and Child entities.

Entitetens ägarskapEntity ownership

Entiteter kan kategoriseras av hur datan i dem ägs.Entities can be categorized by how the data within them is owned. Detta är ett viktigt begrepp för hur säkerhet tillämpas på entiteter.This is an important concept related to how security is applied to entities. Informationen finns i OwnershipType-egenskapen.This information is in the OwnershipType property. I följande tabell beskrivs de olika ägarskapstyperna:The following table describes the different ownership types:

Typ av ägarskapOwnership Type BeskrivningDescription
BusinessBusiness Data som tillhör affärsenheten.Data belongs to the Business unit. Åtkomst till datan kan styras på affärsenhetsnivå.Access to the data can be controlled at the business unit level.
IngenNone Data som inte ägs av någon annan entitet.Data not owned by another entity.
OrganisationOrganization Data som tillhör organisationen.Data belongs to the organization. Åtkomst till datan styrs på organisationsnivå.Access to the data is controlled at the organization level.
Användare eller gruppUser or Team Data som tillhör en användare eller en grupp.Data belongs to a user or a team. Åtgärder som kan utföras på dessa poster kan styras på användarnivå.Actions that can be performed on these records can be controlled on a user level.

När du skapar nya entiteter är de enda ägarskapsalternativen: Organisation eller Användare eller grupp.When you create new entities, the only ownership options are: Organization or User or Team. När du gör ett val för det här alternativet kan du inte ändra det.Once you make a choice for this option, you cannot change it. Välj Användare eller grupp för att få den mest detaljerade kontrollen över vem som kan visa eller utföra åtgärder på posterna.Choose User or Team for the most granular control over who can view or perform actions on the records. Välj Organisation när den här kontrollnivån inte behövs.Choose Organization when this level of control is not necessary.

AktivitetsentiteterActivity entities

En aktivitet är en uppgift som utförs, eller som ska utföras, av en användare.An activity is a task performed, or to be performed, by a user. En aktivitet är de åtgärder som man kan skapa en post för i en kalender.An activity is any action for which an entry can be made on a calendar.

Aktiviteter skiljer sig från andra typer av entiteter som lagrar affärsdata.Activities are modeled differently from other kinds of entities that store business data. Information om aktiviteter visas ofta tillsammans i en lista, men varje typ av aktivitet kräver unika egenskaper.Data about activities is frequently displayed together in a list, yet each kind of activity requires unique properties. I stället för att ha en enda aktivitetsentitet med varje möjlig egenskap, finns det olika typer av aktivitetsentiteter. Var och en av dem ärver egenskaper från en grundläggandeActivityPointer-entitet.Rather than have a single Activity entity with every possible property, there are separate kinds of activity entities and each of them inherits properties from a base ActivityPointer Entity. Dessa entiteter har IsActivity-egenskapen angiven till sant.These entities will have the IsActivity property set to true.

EnhetEntity BeskrivningDescription
AppointmentAppointment Åtagande som visar ett tidsintervall med start-och sluttider samt varaktighet.Commitment representing a time interval with start/end times and duration.
EmailEmail Aktivitet som levereras med hjälp av e-postprotokoll.Activity that is delivered using email protocols.
FaxFax Aktivitet som spårar samtalsresultat och antal sidor för ett fax. Det kan också lagra en elektronisk kopia av dokumentet.Activity that tracks call outcome and number of pages for a fax and optionally stores an electronic copy of the document.
LetterLetter Aktivitet som spårar leveransen av ett brev.Activity that tracks the delivery of a letter. Aktiviteten kan innehålla en elektronisk kopia av brevet.The activity can contain the electronic copy of the letter.
PhoneCallPhoneCall Aktivitet som spårar ett telefonsamtal.Activity to track a telephone call.
RecurringAppointmentMasterRecurringAppointmentMaster Huvudmöte i en återkommande mötesserie.The Master appointment of a recurring appointment series.
SocialActivitySocialActivity Endast för internt bruk.For internal use only.
TaskTask Generisk aktivitet som representerar arbete som behöver göras.Generic activity representing work needed to be done.

När någon av dessa typer av aktivitetsentitetsposter skapas, kommer en motsvarande ActivityPointer-entitetspost skapas med samma ActivityId-attributvärde som unik identifierare.Whenever anyone creates one of these kinds of activity entity records, a corresponding ActivityPointer entity record will be created with the same ActivityId unique identifier attribute value. Det går inte att skapa, uppdatera eller ta bort instanser av ActivityPointer-entiteten, men du kan hämta dem.You cannot create, update, or delete instances of the ActivityPointer entity, but you can retrieve them. Det innebär att alla typer av aktiviteter kan visas tillsammans i en lista.This is what allows all types of activities to be presented together in a list.

Du kan skapa anpassade aktivitetsentiteter som fungerar på samma sätt.You can create custom activity entities that behave the same way.

ActivityParty-entitetActivityParty entity

Den här entiteten används för att ge struktur till aktivitetsentitetens PartyListType-attribut som innehåller referenser till andra entiteter.This entity is used to add structure to activity entity PartyListType attributes that include references to other entities. Du använder entiteten när du anger värden för aktivitetens entitetsattribut, t.ex. Email.to eller PhoneCall.from.You will use this entity when setting values for activity entity attributes like Email.to or PhoneCall.from. I ActivityParty-entiteten anger du attributet ParticipationTypeMask för att definiera den roll som referensen har.Within the ActivityParty entity, you set the ParticipationTypeMask attribute to define the role that the reference is playing. Roller inkluderar Sender, ToRecipient, Organizer och mycket mer.Roles include Sender, ToRecipient, Organizer and more.

Du kan fråga efter ActivityParty-entiteten, men du kan inte skapa, hämta, uppdatera eller ta bort en aktivitetspart utanför den aktivitet som den är kopplad till.You can query the ActivityParty entity, but you cannot create, retrieve, update, or delete an activity party outside of the activity that it is related to. Mer information:More information:

Underordnade entiteterChild entities

Entiteter där IsChildEntity-egenskapen är sant kommer aldrig ha några definierade behörigheter och aldrig ägas av användare eller grupper.Entities where the IsChildEntity property is true will never have any privileges defined and will never be User or Team owned. De åtgärder som kan utföras på en underordnad entitet gäller bara för den entitet som de är kopplade till via en många-till-en-relation.Operations that can be performed on a child entity are bound to an entity that they are associated to via a Many-to-one relationship. Användarna kan bara utföra åtgärder på underordnade entiteter om de kan utföra samma åtgärd på den relaterade entiteten.Users can only perform operations on child entities if they can perform the same operation on the related entity. Underordnade entiteter tas bort automatiskt när den entitetspost som de är beroende av tas bort.Child entities get deleted automatically when the entity record they depend on is deleted.

Till exempel är PostComment, PostLike och PostRole underordnade till Post-entiteten.For example, PostComment, PostLike, and PostRole are each children of the Post entity.

EntitetsnycklarEntity keys

Varje alternativ nyckeldefinition beskriver ett eller flera attribut som i kombination är en unik identifikation av en entitetsinstans.Each alternate key definition describes one or more attributes in combination that will uniquely identify an entity instance. Alternativa nycklar tillämpas vanligtvis bara på integration med externa system.Alternate keys are typically only applied for integration with external systems. Du kan definiera alternativa nycklar till att unikt identifiera en post.You can define alternate keys to uniquely identify a record. Detta är användbart om du integrerar data med ett system som inte stöder GUID-nycklar för unik identifiering.This is valuable if you are integrating data with a system that doesn’t support GUID unique identifier keys. Du kan definiera ett enskilt fältvärde eller en kombination av fältvärden för att unikt identifiera en entitet.You can define a single field value or combination of field values to uniquely identify an entity. Om du lägger till en alternativ nyckel tillämpas en unikhetsbegränsning på dessa attribut.Adding an alternate key will enforce a uniqueness constraint on these attributes. Du kommer inte kunna skapa eller uppdatera någon annan post med samma värden.You will not be able to create or update another entity record to have the same values.

Mer information:More information:

EntitetsstatusEntity states

De flesta entiteter har två egenskaper som spårar status för en post.Most entities have two properties to track the state of a record. Dessa är StateCode, som kallas Status i modelldrivna appar och StatusCode, som kallas Statusorsak i modelldrivna appar.These are StateCode, which is called Status in model-driven apps and StatusCode, which is called Status Reason in model-driven apps.

Båda attributen innehåller en uppsättning med alternativ som visar de giltiga värdena.Both attributes contain a set of options that display the valid values. Attributvärdena StateCode och StatusCode länkas så att endast vissa StatusCode-alternativ är giltiga för en viss StateCode.The StateCode and StatusCode attribute values are linked so that only certain StatusCode options are valid for a given StateCode.

De kan variera per entitet, men det vanliga mönstret för många entiteter och standardvärdet för anpassade entiteter är detta:This can vary by entity but the common pattern for many entities, and the default for custom entities is this:

StateCode-alternativStateCode Options StatusCode-alternativStatusCode Options
0 : Aktiv0 : Active 1 : Aktiv1 : Active
1: Inaktiv1: Inactive 2: Inaktiv2: Inactive

Vissa entiteter har olika uppsättningar med alternativ.Some entities will have different sets of options.

Exempel: PhoneCall-entitet StateCode och StatusCode-alternativExample: PhoneCall entity StateCode and StatusCode options

StateCode StatusCode
0 : Öppen0 : Open 1: Öppen1: Open
1 : Slutförd1 : Completed 2: Utförd2: Made
4: Mottagen4: Received
2: Annullerad2: Cancelled 3: Annullerad3: Cancelled

En uppsättning med giltiga statuskoder för en entitet kan inte anpassas, men statuskoderna är anpassningsbara.The set of valid state codes for an entity is not customizable, but the status codes are customizable. Du kan lägga till ytterligare StatusCode-alternativ för en motsvarande StateCode.You can add additional StatusCode options for a corresponding StateCode.

För anpassade entiteter kan du definiera ytterligare kriterier för giltiga övergångar mellan statusar.For custom entities, you can define additional criteria for valid transitions between statuses. Mer information:More information:

Se ocksåSee also

Entiteter i Common Data Service för apparCommon Data Service for Apps entities