Despre referinta entitatii (Ghidul dezvoltatorului pentru Dynamics 365 Customer Engagement)

• 04/02/2019
• 3 minute de citit

• • K

  • p

In acest articol

Utilizati aceasta referinta pentru a intelege operatiunile disponibile care pot fi efectuate pentru anumite entitati, atributele implicite ale fiecarei entitati si relatiile dintre entitati.

Mesaje

Mesajele din aceasta lista sunt aplicabile entitatii. De exemplu, entitatile detinute de utilizatori accepta mesajele Assign, GrantAccess, ModifyAccess si RevokeAccess in timp ce entitatile detinute de organizatie nu. Alte entitati vor avea mesaje specializate, cum ar fi DeleteAuditData care se aplica numai entitatii de audit.

Serviciul de organizare

Cand utilizati serviciul Organizatie, puteti invoca de obicei clasa de solicitare corespunzatoare care va apartine fie spatiilor de nume Microsoft.Crm.Sdk.Messages, fie Microsoft.Xrm.Sdk.Messages. Aceste clase au nume care includ prefixul Cerere adaugat la numele mesajului.

Unele mesaje sunt adaugate ca actiuni personalizate pentru solutiile pe care le accepta. Aceste mesaje nu sunt definite in cadrul ansamblurilor SDK, dar dezvoltatorii .NET pot genera clase puternic tastate pentru actiuni utilizand instrumentul de generare a codului (CrmSvcUtil.exe) sau utilizand clasa OrganizationRequest. Mai multe informatii: Generati tipuri de legaturi timpurii pentru o actiune si.

API Web

Cand utilizati API-ul Web, puteti invoca de obicei functia sau actiunea corespunzatoare cu acelasi nume ca mesajul. Nu toate mesajele care pot fi invocate folosind ansamblurile SDK au o functie sau actiune API Web corespunzatoare. De exemplu, mesajul SetState este depreciat si nu a fost implementat pentru API-ul Web.

Proprietati entitate

Aceasta sectiune include proprietatile entitatii selectate, mai degraba decat toate. Sunt incluse doar acele proprietati asteptate a fi cele mai utile pentru dezvoltatori. Unele proprietati ale entitatii pot fi modificate. Daca trebuie sa gasiti proprietati care nu sunt enumerate aici sau pentru a vedea valorile curente ale proprietatii din mediul dvs., consultati Rasfoiti metadatele pentru organizatia dvs.

Atribute

Atributele sunt listate in doua sectiuni separate: Atribute scrise si Atribute numai citire . Scopul acestei separari este de a se concentra asupra atributelor pe care un dezvoltator le poate seta atunci cand creeaza sau actualizeaza o instanta de entitate. Intelegerea acestor atribute ajuta un dezvoltator sa inteleaga ce poate face cu entitatea dincolo de simpla recuperare a valorilor.

Atributele din inscriptionabil atributele sectiunea return true pentru fie a IsValidForCreate sau IsValidForUpdate proprietati, ( de obicei ambele). Daca oricare dintre aceste proprietati returneaza fals, acest lucru este indicat.

Atributele numai in citire sunt intotdeauna returnate false pentru proprietatile IsValidForCreate si IsValidForUpdate .

Relatii

Clasa EntityMetadata include trei proprietati pentru a reprezenta relatiile:

Tip proprietate Descriere OneToManyRelationships OneToManyRelationshipMetadata [] Obtine matricea de relatii de la unul la mai multi pentru entitate. ManyToOneRelationships OneToManyRelationshipMetadata [] Obtine gama de relatii multi-la-unu pentru entitate. ManyToManyRelationships ManyToManyRelationshipMetadata [] Obtine matricea de relatii de la multi la multi pentru entitate.

Relatii intre multi

Pentru a demonstra ca nu exista relatii Multe la unu cu un minim de confuzie, detaliile fiecarei relatii sunt documentate o singura data. Fiecare relatie One-to-Many este listata cu entitatea la care se face referire si include detalii despre relatii selectate si un link catre relatia correspondenta Many-to-One . Fiecare relatie Multi-la-unu listata include doar un link catre relatia One-to-Many corespunzatoare.

Relatii Multe-Multe

Fiecare relatie Many-to-Many include Entity1LogicalName si Entity2LogicalName. Pentru aceasta documentatie, detaliile relatiei sunt incluse numai in subiectul pentru Entity1 . Fiecare relatie Multe la Multe in care entitatea este Entitate2 include doar un link catre detaliile gasite in subiectul pentru Entitate1 .