Comparteix a través de


Acerca de la referencia de entidades

Utilice esta referencia para comprender las operaciones disponibles que se pueden realizar para entidades específicas, los atributos predeterminados de cada entidad y las relaciones entre entidades.

Nota

Esta referencia se genera a partir de un inquilino con varias soluciones de Dynamics 365 instaladas, pero no está personalizada. Esto incluye entidades que es posible que no existan en su entorno puesto que estas soluciones no están instaladas. Entidades, atributos y relaciones personalizadas que no se pueden incluir aquí.

Esta referencia incluye solo entidades donde:

  • IsPrivate es igual a false
    • Esto excluye entidades donde no existe ningún caso de uso externo.
  • IsIntersect es igual a false
    • Esto excluye entidades que se usan para definir relaciones de varios a varios.
  • La entidad admite algún tipo de operación.
    • Esto excluye entidades que no puede usar.

Para ver toda la información de metadatos de una entidad para su entorno, vea Exploración de los metadatos de su organización.

Mensajes

Los mensajes de esta lista son aplicables para la entidad. Por ejemplo, las entidades que pertenecen al usuario admiten los mensajes Assign, GrantAccess, ModifyAccess y RevokeAccess mientras que las entidades que pertenecen a la organización no los admiten. Otras entidades tendrán mensajes especializados, como DeleteAuditData que se aplica solo a la entidad de auditoría.

Servicio de la organización

Cuando se usa el servicio de la organización, normalmente puede invocar la clase de solicitud correspondiente que pertenecerá a los espacios de nombres Microsoft.Crm.Sdk.Messages o Microsoft.Xrm.Sdk.Messages. Estas clases tienen nombres que incluyen el prefijo Request agregado al nombre del mensaje.

Algunos mensajes se agregan como acciones personalizadas para las soluciones que admiten. Estos mensajes no se definen en los conjuntos SDK pero los desarrolladores .NET pueden generar clases con establecimiento inflexible de tipos para acciones mediante la herramienta de generación de código (CrmSvcUtil.exe) o con la clase OrganizationRequest. Más información: Generar tipos de enlace en tiempo de compilación para una acción.

Web API

Cuando se utiliza la API web, normalmente puede invocar a la función o a la acción correspondiente con el mismo nombre que el mensaje. No todos los mensajes que se pueden invocar mediante los conjuntos SDK tienen una acción o una función de la API web correspondiente. Por ejemplo, el mensaje SetState ha quedado obsoleto y no se implementó para la API web.

Propiedades de entidad

En esta sección se incluyen las propiedades de entidad seleccionadas en lugar de todos ellas. Solo se incluyen las propiedades que se espera sean más útiles para los desarrolladores. Algunas propiedades de las entidades se pueden cambiar. Si debe buscar propiedades que no aparecen aquí o si desea ver los valores de la propiedad actual en su entorno, consulte Exploración de los metadatos de su organización.

Atributos

Los atributos aparecen en dos secciones separadas: atributos que se pueden escribir y atributos de solo lectura. La finalidad de esta separación es poner el foco en los atributos que un desarrollador puede establecer al crear o actualizar una instancia de entidad. Comprender estos atributos ayuda a un desarrollador a comprender lo que pueden hacer con la entidad aparte de simplemente recuperar los valores.

Los atributos de la sección Atributos que se pueden escribir devuelven un valor true ya sea para la propiedad IsValidForCreate como para IsValidForUpdate, (normalmente para ambas). Si alguna de estas propiedades devuelve un valor false, esto se indica.

Los atributos de solo lectura siempre devolverán un valor false para las propiedades IsValidForCreateeIsValidForUpdate.

Relaciones

La clase EntityMetadata incluye tres propiedades para representar relaciones:

Propiedad Tipo Descripción
OneToManyRelationships OneToManyRelationshipMetadata[] Obtiene la matriz de relaciones de uno a varios para la entidad.
ManyToOneRelationships OneToManyRelationshipMetadata[] Obtiene la matriz de relaciones de varios a uno para la entidad.
ManyToManyRelationships ManyToManyRelationshipMetadata[] Obtiene la matriz de relaciones de varios a varios para la entidad.

Nota

Es importante tener en cuenta que mientras cada entidad muestra las relaciones que se aplican a ella, cada relación está compartida por las dos entidades relacionadas. Las relaciones existen entre entidades. Mientras las relaciones de uno a varios existen, las relaciones de varios a uno son simplemente una vista de una relación de uno a varios desde la entidad de referencia.

Relaciones de uno a varios

Con el fin de representar que no hay ninguna relación de varios a uno real con un mínimo de confusión, los detalles de cada relación solo se documentan una vez. Cada una de las relaciones de uno a varios aparece con la entidad de referencia e incluye detalles de la relación seleccionada y un vínculo a la relación de varios a uno correspondiente. Cada relación de varios a uno que se muestra solo incluye un vínculo a la correspondiente relación de uno a varios.

Relaciones de varios a varios

Cada relación de varios a varios incluye Entity1LogicalName y Entity2LogicalName. Para esta documentación, los detalles de las relaciones solo se incluyen en el tema de Entity1. Cada relación de varios a varios donde la entidad es Entity2, solo incluye un vínculo a los detalles que se encuentran en el tema de Entity1.

Nota

Los conceptos y operaciones del desarrollador relacionados con las ventas en Dynamics 365 Customer Engagement (on-premises) son similares a Dynamics 365 Sales. Para obtener información sobre la extensibilidad de las entidades relacionadas con las ventas, consulte la Guía para desarrolladores de Dynamics 365 Sales.