Comparteix via


Referència de taula/entitat del Dynamics 365 Field Service

Les taules del Dataverse proporcionen el conjunt comú de taules que tenen totes les bases de dades d'entorn.

La referència de taula/entitat de les aplicacions habilitades del Dynamics 365 conté les taules addicionals necessàries per poder instal·lar aplicacions del Dynamics 365 com el Field Service.

Les taules que s'enumeren aquí s'afegeixen o modifiquen quan seleccioneu instal·lar el Dynamics 365 Field Service mentre afegiu el Dataverse a un entorn que creeu. Els esquemes de taula poden tenir un aspecte diferent si hi ha altres aplicacions instal·lades al vostre entorn del Dataverse.

Nota

Aquesta documentació de referència exclou determinades taules que existeixen al vostre entorn. Per exemple, taules que només estan pensades per a ús intern i que considerem menys rellevants per als desenvolupadors del Field Service. Els canvis en els esquemes de taula no es reflecteixen immediatament perquè generem aquesta documentació en determinats intervals.

Hem llançat aquesta documentació de referència el febrer de 2025. És possible que noteu canvis amb més freqüència a mesura que recopilem comentaris inicials i els solucionem.

Per veure la informació actual i no filtrada de totes les taules de l'entorn del Dataverse, utilitzeu el navegador de definicions de taules. El navegador de definicions de taula és una solució administrada descrita a Navegar per definicions de taula al vostre entorn.

Aquesta referència inclou només aquelles taules en què:

  • IsPrivate és igual a false

  • IsIntersect és false igual o IsIntersect és igual true i la taula conté més de 4 columnes.

    • La majoria de les taules d'intersecció contenen només les 4 columnes necessàries per donar suport a la relació de diversos a diversos. No són útils. Les taules d'intersecció amb més de quatre columnes són més interessants.

Missatges

Els missatges d'aquesta llista són aplicables a l'entitat. Per exemple, les taules propietat de l'usuari admeten els missatges , Assign, GrantAccess, i ModifyAccess mentre que les taules propietat de l'organització RevokeAccessno.

SDK per a .NET

Quan utilitzeu l'SDK per a .NET, normalment podeu invocar la classe de sol·licitud corresponent que pertanyerà als espais de noms Microsoft.Crm.Sdk.Messages o Microsoft.Xrm.Sdk.Messages . Aquestes classes tenen noms que inclouen el Request prefix afegit al nom del missatge.

Alguns missatges s'afegeixen com a accions personalitzades per a les solucions que admeten. Aquests missatges no es defineixen dins dels assemblatges de l'SDK, però hi ha diverses maneres d'utilitzar-los.

Web API

Quan utilitzeu l'API web, podeu trobar les funcions i accions comunes de l'OData del Dataverse definides en aquestes referències:

Per a aquestes funcions i accions, i qualsevol altra afegida, podeu descobrir com utilitzar-les mitjançant:

  1. Examineu el document de servei $metadata per obtenir més informació sobre els paràmetres i els valors retornats. Vegeu Definicions d'acció i Definicions de funció per a més detalls.
  2. Invocar accions i funcions. Vegeu Utilitzar accions de l'API web i Utilitzar les funcions de l'API web per obtenir més informació.

Esdeveniments

Els esdeveniments són missatges que existeixen perquè us hi pugueu subscriure. A menys que hàgiu afegit l'esdeveniment, no hauríeu d'invocar el missatge, només subscriure'l. Pots subscriure't a esdeveniments de diverses maneres, per exemple:

Propietats

Aquesta secció inclou les propietats de l'entitat seleccionades en lloc de totes. Només s'inclouen les propietats que s'espera que siguin més útils per als desenvolupadors. Alguns valors de propietat d'entitat es poden canviar.

Columnes

Les columnes es mostren en dues seccions separades: columnes/atributs d'escriptura i columnes/atributs només de lectura. El propòsit d'aquesta separació és centrar-se en les columnes que un desenvolupador pot establir quan crea o actualitza files d'una taula. Entendre aquestes columnes ajuda un desenvolupador a entendre què pot fer amb la taula més enllà de recuperar els valors.

Les columnes de la secció columnes/atributs d'escriptura retornen true per a les propietats IsValidForCreate o IsValidForUpdate (normalment ambdues). Si alguna d'aquestes propietats retorna false, s'indica.

Les columnes o atributs només de lectura sempre retornen false per a les propietats IsValidForCreateiIsValidForUpdate .

Les opcions de columna d'elecció d'aquesta documentació de referència provenen d'una implementació on l'anglès és la llengua base. Algunes opcions d'elecció poden variar en funció de la llengua base seleccionada quan es crea l'entorn. Aquestes diferències s'alineen més amb les opcions que millor s'adapten a l'idioma o la cultura. Podeu personalitzar aquestes opcions canviant les etiquetes o afegint i eliminant opcions segons sigui necessari.

Relacions

La classe EntityMetadata inclou tres propietats per representar relacions:

Propietat Tipus Descripció
OneToManyRelationships OneToManyRelationshipMetadata[modifica] Obté la matriu de relacions d'un a diversos per a l'entitat.
ManyToOneRelationships OneToManyRelationshipMetadata[modifica] Obté la matriu de relacions diversos a un per a l'entitat.
ManyToManyRelationships ManyToManyRelationshipMetadata[modifica] Obté la matriu de relacions de diversos a diversos per a l'entitat.

Nota

És important tenir en compte que, tot i que cada taula enumera les relacions que s'hi apliquen, cada relació és compartida per ambdues taules. Les relacions existeixen entre les taules. Tot i que existeixen relacions d'unTo-Many, les relacions de diversos a un són simplement una visualització d'una relació d'unTo-Many de la taula de referència.

Relacions de diversos a un

Inclou aquestes OneToManyRelationship propietats:

Propietat Descripció
ReferencedEntity El nom lògic de la taula relacionada.
ReferencedAttribute El nom lògic de la clau primària de la taula relacionada.
ReferencingEntity Nom lògic de la taula relacionada que té la columna de cerca.
ReferencingAttribute El nom lògic de la columna de cerca de la taula relacionada que conté una referència a la clau primària de la taula principal.
IsHierarchical Si la relació representa una relació jeràrquica autoreferencial
CascadeConfiguration Les dades que descriuen quines operacions realitzades a l'entitat principal es transferiran en cascada a les entitats relacionades.
Més informació: Configuració en cascada

Relacions d'un a diversos

Inclou aquestes OneToManyRelationship propietats:

Propietat Descripció
ReferencingEntity El nom lògic de la taula relacionada.
ReferencingAttribute El nom lògic de la columna de la taula relacionada que conté una referència a la clau primària de la taula principal.
IsCustomizable Si es poden canviar les propietats de la relació.
ReferencedEntityNavigationPropertyName El nom de la propietat de navegació amb valor de col·lecció de l'API web per a aquesta relació.
Més informació: Propietats de navegació de l'API web
AssociatedMenuConfiguration Dades utilitzades per les aplicacions basades en models per controlar si es pot accedir a les dades de l'entitat relacionada a la interfície d'usuari des de l'entitat principal i com.

Relacions de diversos a diversos

Cada relació de diversos a diversos inclou Entity1LogicalName i Entity2LogicalName. Per a aquesta documentació, els detalls de la relació es proporcionen en el context de la taula actual. Si és Entity1 o Entity2 no és realment important.

Per a cada relació de diversos a diversos s'inclouen les propietats següents:

Propietat Descripció
IntersectEntityName El nom lògic de la taula d'intersecció que admet aquesta relació de diversos a diversos.
Podeu utilitzar aquest valor quan uniu columnes de taula mitjançant FetchXml
IsCustomizable Si es poden canviar les propietats de la relació.
SchemaName El nom de l'esquema de la relació.
IntersectAttribute Nom de la columna de la taula d'intersecció que és la clau principal per als registres d'aquest tipus.
NavigationPropertyName El nom de la propietat de navegació amb valor de col·lecció de l'API web per a aquesta relació.
Més informació: Propietats de navegació de l'API web
AssociatedMenuConfiguration Dades utilitzades per les aplicacions basades en models per controlar si es pot accedir a les dades de la segona taula a la interfície d'usuari des d'aquesta taula i com.

En el cas rar en què una relació de diversos a diversos fa referència automàtica, com ara per a la funció de connexió (ConnectionRole) connectionroleassociation_association, Entity1 o Entity2 està anteposada a la propietat.

Propietat Valor
Entity1IntersectAttribute Nom de la columna de la taula d'intersecció que és la clau principal per als registres d'aquest tipus com a primera taula.
Entity2IntersectAttribute Nom de la columna de la taula d'intersecció que és la clau principal per als registres d'aquest tipus com a segona taula.
Entity1NavigationPropertyName El nom de la propietat de navegació amb valor de col·lecció de l'API web per a aquesta relació com a primera taula.
Entity2NavigationPropertyName El nom de la propietat de navegació amb valors de col·lecció de l'API web per a aquesta relació com a segona taula.
Entity1AssociatedMenuConfiguration Dades utilitzades per les aplicacions basades en models per controlar si es pot accedir a les dades de la segona taula a la interfície d'usuari des d'aquesta taula com a primera taula i com.
Entity2AssociatedMenuConfiguration Dades utilitzades per les aplicacions basades en models per controlar si es pot accedir a les dades de la segona taula a la interfície d'usuari des d'aquesta taula com a segona taula