Inleiding tot entiteiten in Microsoft Dynamics CRM 2015
Gepubliceerd: november 2016
Is van toepassing op: Dynamics CRM 2015
De entiteiten die worden gebruikt om zakelijke gegevens te modelleren en beheren in Microsoft Dynamics 365. Bijvoorbeeld, kunnen de entiteiten zoals account, campagne, en incident (aanvraag) worden gebruikt om verkoop-, marketing-, serviceactiviteiten en bij te houden en te ondersteunen. Een entiteit heeft een serie kenmerken en elk kenmerk vertegenwoordigt een gegevensitem van een bepaald type. Bijvoorbeeld, beschikt de accountentiteit over Name, Address en OwnerId kenmerken. Het concept van een entiteit is, als een databasetabel, en entiteitskenmerken corresponderen met de kolommen. Het maken van een entiteitsrecord (of een record) in Microsoft Dynamics 365 is als het toevoegen van een rij in een databasetabel. De entiteiten zijn uit drie categorieën: systeem, bedrijf, en aangepast. Ontwikkelaar als met zakelijke gegevens werken, zult u zaken en aangepaste entiteiten maken. Systeementiteiten worden gebruikt door Microsoft Dynamics 365 voor alle interne processen, zoals werkstromen en asynchrone taken. U kunt geen systeementiteiten verwijderen of aanpassen.
Bedrijfsentiteiten de maken deel uit van de Microsoft Dynamics 365 standaardinstallatie en deze worden weergegeven in de aanpassingsgebruikersinterface. Een account, een contactpersoon, een en brief zijn voorbeelden van bedrijfsentiteiten. Na de installatie, kunt u aangepaste entiteiten toevoegen in Microsoft Dynamics 365 om te voldoen aan specifieke zakelijke behoeften van de organisatie. In een Microsoft Dynamics 365-oplossing kunt u bedrijfsentiteiten en aangepaste entiteiten en kenmerken instellen als aanpasbaar of niet-aanpasbaar. U kunt een aanpasbare entiteit wijzigen door het veranderen van de naam, door nieuwe kenmerken toe te voegen, of verschillende instellingen, bijvoorbeeld duplicatendetectie of de instellingen van de wachtrijondersteuning te wijzigen. U kunt geen niet-aanpasbare entiteit wijzigen. Voor meer informatie over aanpassing, onbeheerd en beheerde oplossingen, en eigenschappen, raadpleegt u Uitbreidingen inpakken en verdelen met oplossingen.
Als u het verbindende programmeringsmodel gebruikt, wordt een entiteit weergegeven door een klasse, zoals de Account klasse die de accountentiteit vertegenwoordigt. De entiteitskenmerken worden weergegeven door klasse-eigenschappen. Deze klasse wordt gegenereerd door het hulpmiddel CrmSvcUtil. Zie De eerder gebonden entiteitklassen in code gebruiken voor meer informatie. U kunt ook, programma's schrijven die werken met entiteitgegevens door een dynamische manier te gebruiken. Zie De later gebonden entiteitklasse in code gebruiken voor meer informatie.
Notitie
In de Microsoft Dynamics CRM SDK - documentatie, wordt de term "entiteitskenmerk" onderling verwisselbaar met de term "kenmerk" en de term "eigenscha[" (klasse-eigenschap).
In dit onderwerp
Metagegevens entiteit
Acties op entiteitsrecords
Entiteiteigendom
Recordstatus en status
Entiteitsafbeeldingen
Metagegevens entiteit
De metagegevens voor een Microsoft Dynamics 365 - organisatie bevat de definities voor de entiteiten, kenmerken en relaties tussen de entiteiten. Zie De metagegevens en gegevensmodellen in Microsoft Dynamics CRM 2015 voor meer informatie. Voor ontwikkelaars zijn er een groot aantal aanvragen waar het nuttig is alle metagegevens voor een organisatie is kunnen vinden. Er zijn verschillende manieren de metagegevens die u kunt raadplegen:
U kunt de entiteit browser voor metagegevens gebruiken om entiteiten en hun eigenschappen te bekijken in Microsoft Dynamics 365. Zie voor details, Blader door de metagegevens voor uw organisatie.
Het SDK-pakket bevat dezelfde informatie in een Microsoft Office Excel - werkblad. U vindt deze in het bestand SDK\Tools\EntityMetadata.xlsx.
U kunt de metagegevens voor uw organisatie maken met deze voorbeelden:
U kunt de volgende typen relaties tussen entiteiten maken: veel-op-een, een-op-veel en veel-op-veel. Voor de records voor veel-op-veel-relaties worden opgeslagen in doorsnedenentiteit. Nadat een relatie is gedefinieerd, gebruikt u het AssociateRequest bericht of de Associate methode om een koppeling te maken tussen specifieke records en gebruikt u het DisassociateRequest bericht of de Disassociate methode om een koppeling tussen specifieke records te verwijderen.
In een-op-veel-relaties relaties in en veel-op-een relaties hebben sommige acties op de bovenliggende entiteitrecord invloed op de onderliggende entiteitrecords. De acties die trapsgewijs gedrag vertonen zijn onder andere: Toewijzen, Verwijderen, Toevoegen Samenvoegen, Delen, Delen opheffen en Nieuw bovenliggend element maken. Zie Entiteitsrelatiegedrag voor meer informatie.
Namen in metagegevens worden gebruikt
De entiteiten, kenmerken, en de verschillende relaties hebben verschillende namen. De volgende tabel vindt u een lijst met de verschillende namen in de metagegevens zijn gebruikt.
Naam |
Beschrijving |
|---|---|
Weergavenaam |
De naam die wordt weergegeven aan de gebruiker. |
Verzamelnaam weergeven |
Een meervoudsversie van de weergavenaam. Dit geldt alleen voor entiteiten. |
Logische naam |
De unieke naam van de entiteit of kenmerk. Deze naam is in kleine letters. |
Schemanaam |
De schemanaam is opgegeven op maken. Deze moet uniek zijn. Deze wordt gebruikt om de logische naam te maken. Deze naam moet in Pascalcase zijn. De schemanaam wordt gebruikt om de klasse voor de entiteit te maken bij het gebruik van eerder gebonden programmering. |
Notitie
Voor een aangepaste entiteit, kenmerk, en een relatie gemaakt in de context van een beheerde oplossing, wordt het aanpassingsvoorvoegsel in de logische en schemanamen gedefinieerd in het kenmerk Publisher.CustomizationPrefix. Voor een aangepaste entiteit die met programmering wordt gemaakt, kunt u het aanpassingsvoorvoegsel instellen naar een tekenreeks van tussen twee en acht tekens lang, met alleen alfanumerieke tekens en het moet beginnen met een letter. Het kan niet met "mscrm" beginnen. Voor meer informatie over de aanpassing van de metagegevens van een entiteit en de naamconventies, raadpleegt u Metagegevens van entiteiten aanpassen.
Acties op entiteitsrecords
Elke entiteit ondersteunt verschillende acties, bijvoorbeeld maken of verwijderen een record, of wijs een record toe aan een andere gebruiker of een team. Niet alle acties zijn toegestaan op alle entiteitstypen of kenmerken. Voor elk kenmerk, definieert de metagegevens of een bepaalde actie wordt ondersteund. Bijvoorbeeld, de eigenschappen van een kenmerk, zoals, IsValidForCreate, IsValidForRead en IsValidForUpdate vertellen u of u het kenmerk kan maken, ophalen of bijwerken.Meer informatie:Geldige bewerkingen op kenmerken.
Voor het uitvoeren van een actie, roept u een van de methoden aan in IOrganizationService. Bijvoorbeeld, als u een record in Microsoft Dynamics 365 te maken, kunt u gebruiken IOrganizationService.Create methode of IOrganizationService.Execute methode met het bijbehorende bericht CreateRequest. U moet de juiste bevoegdheden en de toegangsrechten hebben om deze acties uit te voeren. Zie Het beveiligingsmodel van Microsoft Dynamics CRM 2015 voor meer informatie.
In de volgende tabel staan de acties die zijn toegestaan op zakelijke en aangepaste entiteitrecords en methoden en de berichten die die u kunt gebruiken om deze acties uit te voeren.
Actie |
Beschrijving |
Methode en/of Bericht |
|---|---|---|
Maken |
Hiermee wordt een record van een specifiek entiteitstype gemaakt, o.a voor aangepaste entiteiten. |
|
Bijwerken |
Het wijzigen van de inhoud van een record. |
|
Verwijderen |
Verwijdert een record. |
|
Ophalen |
Haalt een record op. |
|
Meerdere ophalen |
Haalt een verzameling records op. |
|
Toewijzen |
Hiermee wordt de recordeigendom gewijzigd. Geldig voor entiteiten die eigendom zijn van een gebruiker of eigendom van een team. |
|
Delen |
Geeft, gewijzigd of herroept toegang tot een record aan een andere gebruiker of een team. Geldig voor entiteiten die eigendom zijn van een gebruiker of eigendom van een team. |
|
Associate |
Maakt een koppeling tussen een record en een verzameling records waar er een relatie is tussen de entiteiten. |
|
Ontkoppelen |
Verwijdert een koppeling tussen een record en een verzameling records waar er een relatie is tussen de entiteiten. |
|
Status instellen |
Stel de status in van een record. |
Maken
Om deze taak uit te voeren, moet de aanroeper beschikken over Create message privileges. De toegangsrechten gelden niet voor de actie Maken, maar ze koppelen aan de record toe nadat het is gemaakt.
Als u een record-eigenaar wilt zijn of het nieuw gemaakte record ophalen, moet een gebruiker of een team bevoegdheden en toegangsrechten op de nieuwe record en dat is. Bijvoorbeeld, als u de bevoegdheden hebt voor accounts maken, kunt u een record maken met het recordtype account aan een andere gebruiker of team toewijzen. Echter, tenzij u ook de bevoegdheid lezen voor accounts hebt, en toegangsrechten voor het nieuwe record kunt u geen accountrecord maken en de eigenaar zijn van dat nieuwe account.
Bijwerken
Om deze acties uit te voeren, heeft de aanroeper Update message privileges en toegangsrechten voor de entiteitsrecords die worden bijgewerkt.
Wanneer u een record bijwerkt, worden alleen de gegevens waarvoor u kenmerken hebt opgegeven of waarvoor u opgeeft als null bijgewerkt. Alle andere waarden hetzelfde blijven. Ook u, wanneer u gegevens voor kenmerken opgeeft die niet geldig zijn voor bijwerken, worden zij genegeerd.
Verwijderen
Om deze acties uit te voeren, heeft de aanroeper Delete message privileges en toegangsrechten voor de entiteitsrecords die worden verwijderd nodig.
De trapsgewijze regels bepalen of de verwante records tegelijk worden verwijderd. Zie Entiteitsrelatiegedrag voor meer informatie.
Doorgaans hoeft u alleen records te verwijderen die u per ongeluk hebt ingevoerd. Voor bepaalde recordtypen kunt u de record ook deactiveren of sluiten in plaats van verwijderen. Niet alle recordtypen kunnen worden verwijderd.
Ophalen
Om deze acties uit te voeren, heeft de aanroeper Retrieve message privileges en toegangsrechten voor de entiteitsrecords die worden opgehaald nodig.
Meerdere ophalen
Om deze acties uit te voeren, heeft de aanroeper Retrieve message privileges en toegangsrechten voor de entiteitsrecords die worden opgehaald nodig.
Om een verzameling records op te halen op basis van de queryparameters, kunt u een query-expressie of fetchxml-querytaal gebruiken. Met de query-expressies kunt u een querystructuur maken door een klassehiërarchie te gebruiken. De methoden die worden query-expressie gebruiken leveren een verzameling van sterke getypte records. Met FetchXML kunt u een query maken door een XML-taal te gebruiken. FetchXML levert een XML-tekenreeks. Daarom moet u meer gegevensmanipulatie doen om de queryresultaten gebruiken. Zie Gegevens ophalen met query's voor meer informatie.
Toewijzen
Voor entiteiten die eigendom zijn van een gebruiker of team, wijst u een record aan een nieuwe eigenaar worden toe. Zie Entiteiteigendom voor meer informatie. Om deze acties uit te voeren, heeft de aanroeper Assign message privileges en toegangsrechten voor de entiteitsrecords nodig.
De trapsgewijze regels bepalen of de verwante records tegelijk aan een andere gebruiker worden toegeschreven. Zie Entiteitsrelatiegedrag voor meer informatie.
Wanneer een record aan een andere gebruiker of wachtrij is toegewezen, heeft de vorige eigenaar nog toegang tot deze record als het kenmerk dat ShareToPreviousOwnerOnAssign is ingesteld op true. Echter, wordt de vorige eigenaar niet meer de eigendom van de record.
Delen
Voor entiteiten die eigendom zijn van een gebruiker of team, kunt u een record delen met andere gebruikers of teams. Om deze acties uit te voeren, heeft de aanroeper GrantAccess message privileges , ModifyAccess message privileges en RevokeAccess message privileges nodig en toegangsrechten voor de entiteitsrecords.
De trapsgewijze regels bepalen of de verwante records tegelijk worden gedeeld. Zie Entiteitsrelatiegedrag voor meer informatie
Delen is de gebruikers van manier waarop Microsoft Dynamics 365 gebruikers andere gebruikers toegang tot klantgegevens kunnen geven naar wens. Bijvoorbeeld een verkoper kan ervoor kiezen een verkoopkans aan een andere verkoper wilt delen zodat deze beide de voortgang van belangrijke een verkoop kan bijhouden.
Gebruik de GrantAccessRequest om een record te delen. Gebruik ModifyAccessRequest om te wijzigen hoe een record wordt gedeeld. Gebruik de RevokeAccessRequest om het delen voor een record te verwijderen.
Moet een gebruiker de rechten voor delen hebben om klantgerelateerde records, zoals contactpersonen, accounts, verkoopkansen, aanvragen en orders te delen met een andere gebruiker in Microsoft Dynamics 365. Wanneer een record wordt gedeeld, kunt u de rechten opgeven voor de gedeelde record toe te wijzen.
In de volgende lijst vindt u een beschrijving van de regels om records te delen:
Iedereen met deelbevoegdheden op een record kan deze met andere gebruikers of teams delen.
Iedereen met deelbevoegdheden voor een record kan de toegangsrechten voor deze record instellen. Deze toegangsrechten bepalen hoe een gebruiker die een record deelt toegang tot deze record kan krijgen.
De toegang voor een gedeelde record kan op alle rechten zijn ingesteld, bijvoorbeeld, lezen of schrijven.
De toegangsrechten op een gedeelde record zijn verschillend voor elke gebruiker met wie de record gedeeld wordt.
Het kan een record met dezelfde beveiligingsprincipal slechts één keer worden gedeeld. Een gebruiker kan een record delen als deze aandeelbevoegdheden heeft voor dat record.
Iedereen met deelbevoegdheden op een bedrijfsrecord kan de toegangsrechten voor gebruikers wijzigen van het gedeelde record.
Iedereen met deelbevoegdheden op een bedrijfsrecord kan de toegangsrechten voor een specifieke gebruiker verwijderen van het gedeelde record.
Iedereen met deelbevoegdheden op een bedrijfsrecord kan de toegangsrechten voor alle gebruiker verwijderen met wie het record eerder gedeeld was.
Associate
Om deze acties uit te voeren, heeft de aanroeper Associate message privileges en toegangsrechten voor de records nodig die worden bijgewerkt.
Koppelen maakt meerdere koppelingen in één transacties tussen het opgegeven record en elke record in de verzameling opgegeven voor de relatie opgegeven.
Voor een een-op-veel-relatie, stelt deze methode ReferencingAttribute in de gerelateerde record naar de id opgegeven van de record.
Voor een veel-op-veel-relatie, maakt deze methode een record in een snijpunttabel voor de relatie, dat de id van zowel de verwijzende als de naar verwezen records bevat. De snijpunttabel naam wordt gedefinieerd in de IntersectEntityName-eigenschap voor de relatie.
Ontkoppelen
Om deze acties uit te voeren, heeft de aanroeper Disassociate message privileges en toegangsrechten voor de records nodig die worden bijgewerkt.
Ontkoppelen maakt de gerelateerde bewerking ongedaan, de het verwijzende en de naar verwezen records bij te werken en het doorsnedenrecord te verwijderen waar nodig. Zie Associate voor meer informatie.
Status instellen
Om deze acties uit te voeren, heeft de aanroeper SetState message privileges en toegangsrechten voor de records nodig die worden bijgewerkt. Het SetStateRequest bericht werkt de kenmerken van StateCode en StatusCode kenmerken bij van de entiteitsrecord.
Entiteiteigendom
Er zijn een aantal verschillende typen entiteiteigendom. De meeste entiteiten, o.a voor aangepaste entiteiten, worden eigendom van de organisatie, van een gebruiker, of een team. Er zijn enkele bedrijfsentiteiten die geen eigenaar hebben , zoals type korting (kortingslijst), waarbij het eigendom wordt gedefinieerd door de bovenliggende entiteitkorting. Het type eigendom bepaalt of sommige bewerkingen die op een record kunnen worden uitgevoerd. De eigenaar voor een entiteit wordt gedefinieerd in de metagegevenseigenschap OwnershipType. De volgende tabel geeft de eigendomseigenschappen weer.
Eigendomstype |
Beschrijving |
|---|---|
Eigendom van de organisatie |
Bevat gegevens over iets dat behoort of kan worden bekeken door de hele organisatie. De entiteiten die eigendom zijn van de organisatie kunnen niet worden toegewezen of gedeeld. Bijvoorbeeld, producten zijn eigendom van de organisatie. Deze entiteiten hebben een kenmerk genaamd organizationid. |
Eigendom van het bedrijf |
Entiteiten die aan een business unit behoort. Deze entiteiten hebben een kenmerk genaamd owningbusinessunit. |
Eigendom van gebruiker of team |
Toegewezen aan een gebruiker of team. Deze entiteiten bevatten gegevens over klanten, zoals accounts of contactpersonen die hebben. Beveiliging kan volgens de business unit van de gebruiker of het team zijn gedefinieerd. Deze entiteiten hebben een kenmerken genaamd owningteam en owninguser. |
Geen |
Deze entiteiten worden niet het eigendom van een andere entiteit. |
Meer Informatie over Teameigendom of Gebruiker
U kunt het bericht AssignRequest gebruiken om de eigendom van een record wilt wijzigen. Zie Toewijzen voor meer informatie. U kunt ReassignObjectsOwnerRequest of het bericht ReassignObjectsSystemUserRequest gebruiken om bulkgewijze hernieuwde toewijzing van alle records voor een eigenaar.
Notitie
Met eigenaar aan gebruikers of teams te beperken, beschermt u toegang tot gegevens van gemachtigde gebruikers in de organisatie. Maar u kunt de gegevenstoegang aan extra gebruikers en teams geven door een entiteitsrecord met hen te delen. U kunt ook een record aan een ander team of gebruiker toewijzen. Het configureren van beveiliging voor entiteiten die eigendom zijn van teams of gebruikers biedt meer toegangsniveaus voor beveiligingsrollen dan voor entiteiten die eigendom zijn van de organisatie. De beveiligingsrollen voor entiteiten die eigendom zijn van een organisatie hebben twee toegangsniveaus: Geen en algemeen. De entiteiten die eigendom zijn van een gebruiker of team hebben vijf toegangsniveaus: Algemeen, Hoog, Lokaal, Basis, en geen.
Recordstatus en status
De meeste bedrijfsentiteiten hebben twee eigenschappen om de status van een record bij te houden. Dit zijn StateCode wat de Status in de Webtoepassing is en StatusCode genaamd, die Reden Van Status is in de Webtoepassing. De StateCode en StatusCode kenmerkwaarden zijn gekoppeld.StateCode is het kenmerk gebruikt intern om de status van de entiteit weer te geven.StatusCode het kenmerk waarmee deze waarde voor de eindgebruiker te geven. De set van de geldige codes van de status van een entiteit is niet aanpasbaar maar de statuscodes kunnen worden aangepast. Voor de entiteit aanvraag en aangepaste entiteiten, kunt u extra criteria definiëren voor geldige overgangn tussen statussen. Zie voor meer informatie Metagegevens van entiteitskenmerken aanpassen en Aangepaste statusmodelovergangen definiëren.
Entiteitsafbeeldingen
Bepaalde systeementiteiten hebben afbeeldingkenmerken. U kunt een afbeeldingskenmerken aan aangepaste entiteiten toevoegen. Wanneer een entiteit een afbeeldingkenmerk heeft, kunt u de eigenschap PrimaryImageAttribute instellen om te controleren of de afbeelding in de toepassing wordt weergegeven. Wanneer de afbeelding in de toepassing wordt weergegeven kunnen gebruikers van de webtoepassing afbeeldingen uploaden voor de entiteitsrecord. De volgende systeementiteiten bevatten afbeeldingskenmerken. Die zijn gemarkeerd met een sterretje standaard ingeschakeld om deze in de toepassing wordt weergegeven.
Account * |
KbArticle |
Campagne |
Incident |
Concurrent * |
Verbinding |
Neem contact op met * |
Contract |
TransactionCurrency |
EmailServerProfile |
Doelstelling |
Factuur |
Potentiële klant * |
Postvak |
Verkoopkansproduct |
Verkooporder |
Organisatie |
Product * |
Uitgever * |
Wachtrij |
Resource * |
SalesLiterature |
Rayon |
SystemUser * |
Meer informatie:Kenmerken voor afbeeldingsgegevens.
Zie ook
Beheer- en beveiligingsentiteiten
Metagegevens gebruiken om entiteitdiagrammen te genereren
Aangepaste statusmodelovergangen definiëren
Entiteitsdiagrammen
Uw bedrijfsgegevens modelleren
Aanpassen metagegevens van entiteitsrelaties
Entiteitsrelatiegedrag
De metagegevens en gegevensmodellen in Microsoft Dynamics CRM 2015
Breid het metagegevensmodel uit
Uitbreidingen inpakken en verdelen met oplossingen
IOrganizationService-entiteiten
Het beveiligingsmodel van Microsoft Dynamics CRM 2015
Voorbeeld: Entiteitsafbeeldingen instellen en ophalen
Voorbeeld: Een record toewijzen aan een team
Voorbeeld: Records delen die de berichten GrantAccess, ModifyAccess en RevokeAccess gebruiken
Voorbeeld: Twee records samenvoegen
Voorbeeld: Recordstatus valideren en status van de record instellen
Voorbeeld: Samentellingsrecords met betrekking tot een specifieke record
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht