Introduktion til objekter i Microsoft Dynamics 365
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Objekterne bruges til at modellere og styre virksomhedsdata i Microsoft Dynamics 365. Objekter som konto-, kampagne, og hændelse (sag) kan f.eks. bruges til at spore og understøtte salgs-, marketing- og serviceaktiviteter. Et objekt har en række attributter, og hver attribut repræsenterer et dataelement i en bestemt type. Objektet firma har f.eks attributterne Name, Address og OwnerId. Begrebsmæssigt er et objekt som en databasetabel, og objektattributterne svarer til tabelkolonnerne. Oprettelsen af en objektpost (eller blot en post) i Microsoft Dynamics 365 svarer til at tilføje en række i en databasetabel. Objekterne er opdelt i tre kategorier: system, forretning og brugerdefineret. Som en udvikler, som arbejder med virksomhedsdata, vil du bruge forretningsobjekter og brugerdefinerede objekter. Systemobjekter bruges af Microsoft Dynamics 365 til at håndtere alle interne processer, f.eks. arbejdsprocesser og asynkrone job. Du kan ikke slette eller tilpasse systemobjekter.
Forretningsobjekter er en del af standardinstallationen af Microsoft Dynamics 365, og de vises i brugergrænsefladen for tilpasning. Et firma, en kontaktperson og et brev er eksempler på forretningsobjekter. Efter installationen kan du tilføje brugerdefinerede objekter til Microsoft Dynamics 365 for at løse specifikke forretningsbehov i organisationen. I en Microsoft Dynamics 365-Løsning kan du angive forretningsobjekter og brugerdefinerede objekter og attributter, der enten kan tilpasses eller ikke kan tilpasses. Du kan redigere et objekt, der kan tilpasses, ved at omdøbe den, tilføje nye attributter eller ved at ændre forskellige indstillinger, f.eks. indstillinger som registrering af dubletter eller understøttelse af kø. Du kan ikke ændre et objekt, der ikke kan tilpasses. Du kan finde flere oplysninger om tilpasning, ikke-administrerede og administrerede løsninger og administrerede egenskaber under Pakke- og distributionsudvidelser ved hjælp af løsninger.
Hvis du bruger programmeringsmodellen med tidlig binding, repræsenterer et objekt af en klasse, f.eks. den Account-klasse, der repræsenterer firmaobjektet. Objektattributter repræsenteres af klasseegenskaber. Denne klasse genereres af værktøjet CrmSvcUtil. Du kan finde flere oplysninger under Brug de tidligt bundne objektklasser i kode. Alternativt kan du skrive programmer, der arbejder med objektdata ved hjælp af en dynamisk tilgang. Du kan finde flere oplysninger under Brug den sent bundne objektklasse i kode.
Bemærk
I Microsoft Dynamics 365-SDK-dokumentationen bruges udtrykket "objektattributten" bruges synonymt med udtrykket "attribut" og udtrykket "egenskab" (klasse egenskab).
Dette emne indeholder
Objektmetadata
Handlinger på objektposter
Objektejerskab
Posttilstand og -status
Objektbilleder
Objektmetadata
Metadataene for en Microsoft Dynamics 365-organisation indeholder definitionerne af objekterne, attributterne og relationerne mellem objekterne. Du kan finde flere oplysninger under Metadataene og datamodellerne i Microsoft Dynamics 365. Der er mange tilfælde, hvor det som udvikler er praktisk at kunne finde alle metadata for en organisation. Der er en række måder, du kan finde og henvise til metadata på:
Du kan bruge objektmetadatabrowseren til at få vist objekter og deres egenskaber i Microsoft Dynamics 365. Du finde flere oplysninger under Gennemse metadata for organisationen.
SDK-pakken indeholder de samme oplysninger i et Microsoft Office Excel-regneark. Du kan finde det i filen SDK\Tools\EntityMetadata.xlsx.
Du kan generere metadataene for organisationen ved hjælp af disse prøver:
Du kan oprette følgende typer relationer mellem objekter: en til mange, mange til en og mange til mange. Posterne for en mange til mange-relation er gemt i et skæringsobjekt. Når en relation er defineret, kan du bruge AssociateRequest.meddelelsen eller Associate-metoden til at oprette en kæde mellem de angivne poster, og bruge DisassociateRequest-meddelelsen eller Disassociate-metoden til at fjerne en kæde mellem de angivne poster.
I en til mange- og mange til en-relationer påvirker visse handlinger på den overordnede objektpost de underordnede objektposter. De handlinger, der har overlappende funktionsmåde, omfatter: tildele, slette, flette, dele, ophæv deling og ny overordnet. Du kan finde flere oplysninger under Relationsfunktionsmåde for objekt.
Navne, der bruges i objektmetadata
Objekter, attributter og relationer har flere forskellige navne. I nedenstående tabel vises de forskellige navne, der bruges i metadataene.
Navn |
Beskrivelse |
|---|---|
Vist navn |
Navnet, der vises til brugeren. |
Visning af samlingsnavn |
En flertalsversion af det viste navn. Dette gælder kun for objekter. |
Logisk navn |
Det entydige navn på objektet eller attributten. Dette navn er kun med små bogstaver. |
Skemanavn |
Skemanavnet angives ved oprettelse. Det skal være entydigt. Det bruges til at oprette det logiske navn. Navnet skal være med Pascal-bogstaver. Skemanavnet bruges til at oprette klassen for objektet, når du bruger programmering med tidlig binding. |
Bemærk
For brugerdefinerede objekter, attributter og relationer, der oprettes i forbindelse med en løsning, defineres tilpasningspræfikset i logiske navne og skemanavne i attributten Publisher.CustomizationPrefix. Når et brugerdefineret objekt oprettes via programmering, kan du angive tilpasningspræfikset til en streng, der har en længde på mellem to og otte tegn, alle alfanumeriske tegn, og som starter med et bogstav. Det kan ikke starte med "mscrm". Du kan finde flere oplysninger om tilpasning af enhedsmetadata og navngivningskonventioner under Tilpasse objektets metadata.
Handlinger på objektposter
Hvert objekt understøtter flere forskellige handlinger, f.eks. oprettelse eller sletning af en post eller tildeling af en post til en anden bruger eller et team. Ikke alle handlinger er tilladt på alle objekttyper eller attributter. For hver attribut definerer metadataene om en given handling understøttes. En attributs egenskaber f.eks. IsValidForCreate, IsValidForRead og IsValidForUpdate fortæller dig, om du kan oprette, hente eller opdatere attributten.Flere oplysninger:Gyldige handlinger på attributter.
Hvis du vil udføre en handling, kalder du en af metoderne i IOrganizationService. Hvis du f.eks. vil oprette en post i Microsoft Dynamics 365, kan du bruge metoden IOrganizationService.Create eller metoden IOrganizationService.Execute med den tilhørende CreateRequest-meddelelse. Du skal have de nødvendige rettigheder og adgangsrettigheder til at udføre disse handlinger. Du kan finde flere oplysninger under Sikkerhedsmodellen for Microsoft Dynamics 365.
I nedenstående tabel vises de handlinger, der er tilladt på forretningsobjektposter og brugerdefinerede objektposter og metoder og meddelelser, som du kan bruge til at udføre disse handlinger.
Handling |
Beskrivelse |
Metode og/eller meddelelse |
|---|---|---|
Opret |
Opretter en post for en bestemt objekttype, herunder brugerdefinerede objekter. |
|
Opdatering |
Ændrer indholdet af en post. |
|
Slet |
Sletter en post. |
|
Hent |
Henter en post. |
|
Hente flere |
Henter en samling af poster. |
|
Tildel |
Ændrer ejerskab for en post. Gyldigt for brugerejede eller teamejede objekter. |
|
Del |
Tildeler, ændrer eller tilbagekalder adgang til en post for en anden bruger eller et team. Gyldigt for brugerejede eller teamejede objekter. |
|
Tilknyt |
Opretter forbindelser mellem en post og en samling af poster, hvor der er en relation mellem objekterne. |
|
Ophæv tilknytning |
Fjerner forbindelser mellem en post og en samling af poster, hvor der er en relation mellem objekterne. |
|
Indstil tilstand |
Angiver tilstanden for en post. |
Opret
Hvis denne handling skal udføres, skal den kaldende have Create message privileges. Adgangsrettigheder gælder ikke for handlingen Opret, men de gælder for posten, når den er blevet oprettet.
For at kunne eje en post eller hente den nyligt oprettede post, skal en bruger eller et team have læserettigheder og adgangsrettigheder til den nye post. Hvis du f.eks. har oprettelsesrettigheder til konti, kan du oprette en firmapost og tildele den til en anden bruger eller et team. Men, medmindre du også har læseadgang til konti og adgangsrettigheder til den nye post, kan du ikke oprette en konto og være ejer af den nye konto.
Opdatering
Hvis denne handling skal udføres, skal den kaldende have Update message privileges og adgangsrettigheder til de objektposter, der skal opdateres.
Når du opdaterer en post, opdateres kun de attributter, som du kan angive data for eller angive null for. Alle andre værdier forbliver de samme. Hvis du angiver data for attributter, der ikke er gyldige til opdatering, ignoreres de også.
Slet
Hvis denne handling skal udføres, skal den kaldende have Delete message privileges og adgangsrettigheder til de objektposter, der skal slettes.
De overlappende regler bestemmer, om relaterede poster slettes på samme tid. Du kan finde flere oplysninger under Relationsfunktionsmåde for objekt.
Normalt skal du kun slette poster, som du har indtastet ved en fejltagelse. I forbindelse med visse typer poster kan du deaktivere eller lukke posten i stedet for at slette den. Det er ikke alle posttyper, der kan slettes.
Hent
Hvis denne handling skal udføres, skal den kaldende have Retrieve message privileges og adgangsrettigheder til de objektposter, der hentes.
Hente flere
Hvis denne handling skal udføres, skal den kaldende have Retrieve message privileges og adgangsrettigheder til de objektposter, der hentes.
Hvis du vil hente en samling af poster baseret på forespørgselsparametrene, kan du enten bruge et forespørgselsudtryk eller forespørgselssproget FetchXML. Med forespørgselsudtryk kan du opbygge et forespørgselstræ ved hjælp af et klassehierarki. De metoder, der bruges i et forespørgselsudtryk returnerer en samling af typesikre poster. Med FetchXML kan du oprette en forespørgsel ved hjælp af et XML-sprog. FetchXML returnerer en XML-streng. Derfor skal du foretage mere datamanipulation for at kunne bruge resultaterne af forespørgslen. Du kan finde flere oplysninger under Hente data med forespørgsler ved hjælp af SDK-assemblyer.
Tildel
For brugerejede eller teamejede enheder tildeler du en post til en ny ejer. Du kan finde flere oplysninger under Objektejerskab. Hvis denne handling skal udføres, skal den kaldende have Assign message privileges og adgangsrettigheder til objektposterne.
De overlappende regler bestemmer, om relaterede poster er tildelt til en anden bruger på samme tid. Du kan finde flere oplysninger under Relationsfunktionsmåde for objekt.
Når der tildeles en post til en anden bruger eller et team, har den tidligere ejer stadig adgang til denne post, hvis attributten ShareToPreviousOwnerOnAssign er angivet til true. Men, den tidligere ejer har dog ikke længere ejerskabet af posten.
Del
Du kan dele en post for brugerejede eller teamejede objekter med andre brugere eller teams. Hvis denne handling skal udføres, skal den kaldende have GrantAccess message privileges, ModifyAccess message privileges og RevokeAccess message privileges og adgangsrettigheder til objektposterne.
De overlappende regler bestemmer, om relaterede poster deles på samme tid. Du kan finde flere oplysninger under Relationsfunktionsmåde for objekt
Deling er den måde, Microsoft Dynamics 365-brugere efter behov kan give andre brugere adgang til kundeoplysninger på. En sælger beslutter f.eks. at dele salgsmulighed med en anden sælger, så de begge kan spore status for et vigtigt salg.
Brug GrantAccessRequest til at dele en post. Brug ModifyAccessRequest til at ændre, hvordan en post skal deles. Brug RevokeAccessRequest til at fjerne al deling fra posten.
En bruger skal have delingsrettigheder for at dele kunderelaterede poster, f.eks. kontaktpersoner, firmaer, salgsmuligheder, sager og ordrer, med en anden bruger i Microsoft Dynamics 365. Når en post er delt, kan du angive rettighederne, der tildeles for den delte post.
I nedenstående liste beskrives reglerne for deling af poster:
Alle med delingsrettigheder på en post kan dele den med andre brugere eller teams.
Alle med delingsrettigheder på en post kan angive adgangsrettigheder for den pågældende post. Disse adgangsrettigheder styrer, hvordan en bruger, der deler en post, har adgang til posten.
Adgang til en delt post kan indstilles til enhver adgangsrettighed, f.eks. læse eller skrive.
Adgangsrettigheder til en delt post kan være forskellige for hver enkelt bruger, som posten deles med.
En post kan kun deles med den samme sikkerhedskonto én gang. Brugerne kan dele en post, hvis de har delingsrettigheder til posten.
Alle med delingsrettigheder til en forretningspost kan ændre adgangsrettighederne for brugere, der har den delte post.
Alle med delingsrettigheder til en forretningspost kan fjerne deling for en angivet bruger, der har den delte post.
Alle med delingsrettigheder på en forretningspost kan fjerne deling for alle brugere, som posten tidligere blev delt med.
Tilknyt
Hvis denne handling skal udføres, skal den kaldende have Associate message privileges og adgangsrettigheder til de poster, der skal opdateres.
Tilknyt opretter flere tilknytninger i én transaktion mellem den angivne post, og hver post i den angivne samling for den relation, der er angivet.
For en en til mange-relation indstiller denne metode ReferencingAttribute i den relaterede post til id'et for den angivne post.
For en mange til mange-relation opretter denne metode en post i den overlappende tabel for relationen, der indeholder id'et for både de refererede og refererende poster. Navnet på den overlappende tabel er defineret i IntersectEntityName-egenskaben for relationen.
Ophæv tilknytning
Hvis denne handling skal udføres, skal den kaldende have Disassociate message privileges og adgangsrettigheder til de poster, der skal opdateres.
Ophævelse af tilknytningen vender den tilknyttede handling ved at opdatere de refererede og refererende poster og slette den overlappende post, hvor det er relevant. Du kan finde flere oplysninger under Tilknyt.
Indstil tilstand
Hvis denne handling skal udføres, skal den kaldende have SetState message privileges og adgangsrettigheder til de poster, der skal opdateres. Meddelelsen SetStateRequest opdaterer attributterne StateCode og StatusCode for objektposten.
Objektejerskab
Der findes flere forskellige typer af objektejerskaber. De fleste objekter, herunder brugerdefinerede objekter, ejes af organisationen, en bruger eller et team. Der er nogle forretningsobjekter, der ikke har en ejer, f.eks. rabattype (rabatoversigt), hvor ejerskabet er defineret af dens overordnede objekt rabat. Typen af ejerskab definerer nogle af de handlinger, der kan udføres på en post. Ejerskab for et objekt er defineret i metadataegenskaben OwnershipType. Nedenstående tabel viser egenskaberne for ejerskab.
Ejerskabstype |
Beskrivelse |
|---|---|
Organisationsejet |
Indeholder data, der vedrører noget, der tilhører, eller som kan ses af hele organisationen. Organisationsejede enheder kan ikke tildeles eller deles. Produkter ejes f.eks. af organisationen. Disse enheder har en attribut med navnet organizationid. |
Virksomhedsejet |
Objekter, der tilhører en afdeling. Disse objekter har en attribut med navnet owningbusinessunit. |
Bruger- eller teamejet |
Tildelt til en bruger eller et team. Disse objekter indeholder data, der vedrører kunder, f.eks. firmaer eller kontaktpersoner. Sikkerhed kan defineres i henhold til brugerens eller teamets afdeling. Disse enheder har attributter med navnet owningteam og owninguser. |
Intet |
Disse objekter ejes ikke af et andet objekt. |
Yderligere oplysninger om bruger- eller teamejerskab
Du kan bruge meddelelsen AssignRequest til at ændre ejerskabet af en post. Du kan finde flere oplysninger under Tildel. Du kan bruge meddelelserne ReassignObjectsOwnerRequest eller ReassignObjectsSystemUserRequest til at udføre store gentildelinger af alle poster for en ejer.
Bemærk
Ved at begrænse ejerskab til brugere eller team, kan du begrænse adgangen til data til autoriserede brugere i organisationen. Men, du kan dog udvide dataadgang til flere brugere og teams ved at dele en enhedspost med dem. Du kan også tildele en post til en anden bruger eller et andet team. Konfiguration af sikkerhed for brugerejede eller teamejede objekter giver dig flere adgangsniveauer for sikkerhedsrollerne end for organisationsejede objekter. Sikkerhedsroller for organisationsejede objekter har to adgangsniveauer: ingen og global. De brugerejede eller teamejede objekter har fem adgangsniveauer: global, dyb, lokal, grundlæggende og ingen.
Posttilstand og -status
De fleste forretningsobjekter har to egenskaber til at spore tilstanden for en post. Disse er StateCode, som kaldes Status i webprogrammet, og StatusCode, som kaldes Statusårsag i webprogrammet. Attributværdierne StateCode og StatusCode er sammenkædet. Attributten StateCode bruges internt til at repræsentere status for objektet. Attributten StatusCode bruges til at vise denne værdi for slutbrugeren. Sættet af gyldige tilstandskoder for et objekt kan ikke tilpasses, men statuskoderne kan tilpasses. For sagsobjektet og de brugerdefinerede objekter kan du angive flere kriterier for gyldige overgange mellem statusser. Du kan finde flere oplysninger i Tilpasse objektets attributmetadata og Definere brugerdefinerede overgange af tilstandsmodeller.
Objektbilleder
Visse systemobjekter har billedattributter. Du kan føje billedattributter til brugerdefinerede objekter. Når et objekt har en billedattribut, kan du angive egenskaben PrimaryImageAttribute til at kontrollere, om billedet skal vises i programmet. Når billedet vises i programmet, kan brugere af webprogrammet overføre billeder til objektposten. Følgende systemobjekter har et billedattributter. Dem, der er markeret med en stjerne, er som standard aktiveret til at blive vist i programmet.
Firma * |
KbArticle |
Kampagne |
Hændelse |
Konkurrent * |
Forbindelse |
Kontakt * |
Kontrakt |
TransactionCurrency |
Mailserverprofil |
Mål |
Faktura |
Kundeemne * |
Postkasse |
Salgsmulighedsprodukt |
SalesOrder |
Organisation |
Produkt * |
Udgiver * |
Kø |
Ressource * |
SalesLiterature |
Distrikt |
SystemUser * |
Flere oplysninger:Dataattributter for billede.
Se også
Administration og sikkerhedsobjekter
Bruge metadata til at oprette objektdiagrammer
Definere brugerdefinerede overgange af tilstandsmodeller
Nøgle til objektdiagrammer
Modeller dine virksomhedsdata i Microsoft Dynamics 365
Tilpasse metadata til objektrelationer
Relationsfunktionsmåde for objekt
Metadataene og datamodellerne i Microsoft Dynamics 365
Bruge organisationstjenesten med Dynamics 365-metadata
Pakke- og distributionsudvidelser ved hjælp af løsninger
Organisationsservice-objekter
Sikkerhedsmodellen for Microsoft Dynamics 365
Eksempel: Angive og hente objektbilleder
Eksempel: Tildel en post til et team
Eksempel: Del poster ved hjælp af GrantAccess-, ModifyAccess- og RevokeAccess-meddelelser
Eksempel: Fletning af to poster
Eksempel: Validere posttilstanden og angive tilstanden for posten
Eksempel: Akkumuleringsposter relateret til en bestemt post
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret