Introducción a entidades en Microsoft Dynamics 365

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Las entidades se utilizan para modelar y administrar datos profesionales en Microsoft Dynamics 365. Por ejemplo, las entidades como cuenta, campaña, e incidente (caso) se pueden usar para realizar el seguimiento y el soporte de actividades de ventas, marketing y servicio. Una entidad tiene un conjunto de atributos, cada uno de los cuales representa un elemento de datos de un tipo determinado. Por ejemplo, la entidad cuenta tiene los atributos Name, Address y OwnerId. Conceptualmente, una entidad es como una tabla de base de datos, y los atributos de entidad se corresponden con las columnas de la tabla. Crear un registro de entidad (o registro) en Microsoft Dynamics 365 es como agregar una fila a una tabla de base de datos. Las entidades se dividen en tres categorías: sistema, negocios y personalizadas. Como desarrollador que trabaja con datos profesionales, usará entidades de negocios y personalizadas.Microsoft Dynamics 365 usa las entidades del sistema para administrar todos los procesos internos, como los flujos de trabajo y los trabajos asincrónicos. No puede eliminar ni personalizar las entidades del sistema.

Las entidades de negocios forman parte de la instalación predeterminada de Microsoft Dynamics 365 y aparecen en la interfaz de usuario de personalización. Cuenta, contacto y carta son ejemplos de entidades de negocios. Después de la instalación, puede agregar entidades personalizadas a Microsoft Dynamics 365 para satisfacer necesidades de negocio específicas de la organización. En una solución de Microsoft Dynamics 365, puede establecer entidades y atributos de negocios y personalizados para que sean personalizables o no personalizables. Puede modificar una entidad personalizable cambiando su nombre, agregando nuevos atributos o modificando distintos valores, como la detección de duplicados o la configuración del soporte de la cola. No puede modificar una entidad no personalizable. Para obtener más información acerca de la personalización, las soluciones no administradas y administradas, así como las propiedades administradas, vea Empaquetar y distribuir las extensiones con soluciones.

Si está usando el modelo de programación enlazada en tiempo de compilación, una entidad se representa mediante una clase, como la clase Account, que representa la entidad cuenta. Los atributos de entidad se representan mediante las propiedades de clase. Esta clase se genera mediante la herramienta CrmSvcUtil. Para obtener más información, vea Usar las clases de entidad con enlace en tiempo de compilación en código. También puede escribir programas que trabajen con los datos de entidad mediante un enfoque dinámico. Para obtener más información, vea Usar la clase de entidad con enlace en tiempo de ejecución en código.

En este tema

Metadatos de la entidad

Acciones en los registros de la entidad

Propiedad de la entidad

Estado y razón para el estado de los registros

Imágenes de entidad

Metadatos de la entidad

Los metadatos de una organización de Microsoft Dynamics 365 contienen las definiciones de las entidades y atributos, y las relaciones entre las entidades. Para obtener más información, vea Modelos de datos y metadatos en Microsoft Dynamics 365. Para un desarrollador, existen muchas situaciones en las que es útil poder encontrar todos los metadatos de una organización. Existen varias formas de encontrar y hacer referencia a los metadatos:

• Use el Explorador de metadatos de la entidad para ver las entidades y sus propiedades en Microsoft Dynamics 365. Para obtener más detalles, vea Examinar los metadatos de la organización.

• El paquete del SDK contiene la misma información en una hoja de cálculo de Microsoft Office Excel. Puede encontrarla en el archivo SDK\Tools\EntityMetadata.xlsx.

• Puede generar los metadatos para su organización mediante estos ejemplos:

  • Ejemplo: volcar metadatos de entidad en un archivo

  • Ejemplo: volcar la información de privilegio de entidad en un archivo

  • Ejemplo: volcar metadatos de atributo en un archivo

  • Ejemplo: volcar la información de la relación de entidad en un archivo

  • Ejemplo: volcar la información del conjunto de opciones globales a un archivo

Puede crear los siguientes tipos de relaciones entre entidades: de uno a varios, de varios a uno y de varios a varios. Los registros de una relación de varios a varios se almacenan en una entidad de intersección. Tras definir una relación, use el mensaje AssociateRequest o el método Associate para crear un vínculo entre los registros especificados, y use el mensaje DisassociateRequest o el método Disassociate para quitar un vínculo entre los registros especificados.

En las relaciones de uno a varios o de varios a uno, algunas acciones del registro de la entidad primaria afectan a los registros de la entidad secundaria. Las acciones que tienen un comportamiento en cascada son: Asignar, Eliminar, Combinar, Compartir, Dejar de compartir y Cambiar primario. Para obtener más información, vea Comportamiento de relación de entidades.

Nombres usados en los metadatos de la entidad

Las entidades, los atributos y sus relaciones tienen varios nombres distintos. La siguiente tabla muestra los distintos nombres que se usan en los metadatos.

Acciones en los registros de la entidad

Cada entidad admite varias acciones, como crear o eliminar un registro, o asignar un registro a otro usuario o equipo. No se permiten todas las acciones en todos los tipos o atributos de entidad. Para cada atributo, los metadatos definen si se admite una acción determinada. Por ejemplo, las propiedades de un atributo, como IsValidForCreate, IsValidForRead e IsValidForUpdate le indican si puede crear, recuperar o actualizar el atributo.Más información:Operaciones válida en atributos.

Para realizar una acción, llame uno de los métodos de IOrganizationService. Por ejemplo, para crear un registro en Microsoft Dynamics 365, puede usar el método IOrganizationService.Create o el método IOrganizationService.Execute con el mensaje CreateRequest correspondiente. Debe tener los privilegios y los derechos de acceso necesarios para realizar estas acciones. Para obtener más información, vea El modelo de seguridad de Microsoft Dynamics 365.

En la siguiente tabla se enumeran las acciones que se permiten en los registros de las entidades de negocio y personalizadas, y los métodos y mensajes que puede usar para realizar estas acciones.

Crear

Para llevar a cabo esta acción, el autor de la llamada debe tener Create message privileges. Los derechos de acceso no se aplican a la acción Crear, pero sí se aplican al registro vez que se ha creado.

Para ser el propietario de un registro o recuperar un registro recién creado, un usuario o equipo también debe tener derechos de acceso y privilegios de lectura en el nuevo registro. Por ejemplo, si tiene privilegios de creación para las cuentas, puede crear un registro de cuenta y asignárselo a otro usuario o equipo. Sin embargo, a menos que también tenga el privilegio de lectura para las cuentas y derechos de acceso al nuevo registro, no puede crear una cuenta y ser el propietario de esa nueva cuenta.

Actualización

Para llevar a cabo esta acción, el autor de la llamada debe tener Update message privileges y derechos de acceso a los registros de entidad que se van a actualizar.

Cuando se actualiza un registro, solo se actualizan los atributos para los que se especifican datos o para los que se especifica null. Los demás valores permanecen como estaban. Además, si especifica datos para los atributos que no son válidos para la actualización, se omiten.

Eliminar

Para llevar a cabo esta acción, el autor de la llamada debe tener Delete message privileges y derechos de acceso a los registros de entidad que se van a eliminar.

Las reglas en cascada determinan si los registros relacionados se eliminan al mismo tiempo. Para obtener más información, vea Comportamiento de relación de entidades.

Normalmente solo es necesario eliminar los registros que se han creado por error. Para algunos tipos de registros, es posible desactivar o cerrar el registro en lugar de eliminarlo. No todos los tipos de registro se pueden eliminar.

Recuperar

Para llevar a cabo esta acción, el autor de la llamada debe tener Retrieve message privileges y derechos de acceso a los registros de entidad recuperados.

Recuperar varios

Para llevar a cabo esta acción, el autor de la llamada debe tener Retrieve message privileges y derechos de acceso a los registros de entidad recuperados.

Para recuperar una recopilación de registros en función de los parámetros de consulta, puede usar una expresión de consulta o el lenguaje de consultas FetchXML. Las expresiones de consulta permiten crear un árbol de consultas usando una jerarquía de clases. Los métodos que usan una expresión de consulta devuelven una recopilación de registros con establecimiento inflexible de tipos. FetchXML permite crear consultas mediante un idioma XML. FetchXML devuelve una cadena XML. Por lo tanto, para usar los resultados de la consulta se necesita una mayor manipulación de datos. Para obtener más información, vea Recuperar datos con consultas mediante ensamblados de SDK.

Asignar

Para las entidades que pertenecen a un usuario o equipo, se asigna un registro a un nuevo propietario. Para obtener más información, vea Propiedad de la entidad. Para llevar a cabo esta acción, el autor de la llamada debe tener Assign message privileges y derechos de acceso a los registros de entidad.

Las reglas en cascada determinan si los registros relacionados se asignan a otro usuario al mismo tiempo. Para obtener más información, vea Comportamiento de relación de entidades.

Cuando un registro se asigna a otro usuario o equipo, el propietario anterior sigue teniendo acceso a este registro si el atributo ShareToPreviousOwnerOnAssign está establecido en true. Sin embargo, el propietario anterior ya tendrá la propiedad del registro.

Compartir

Para las entidades que pertenecen a un usuario o a un equipo, puede compartir un registro con otros usuarios o equipos. Para llevar a cabo esta acción, el autor de la llamada debe tener GrantAccess message privileges, ModifyAccess message privileges y RevokeAccess message privileges y derechos de acceso a los registros de entidad.

Las reglas en cascada determinan si los registros relacionados se comparten al mismo tiempo. Para obtener más información, consulte Comportamiento de relación de entidades

El uso compartido es la forma en que los usuarios de Microsoft Dynamics 365 pueden conceder acceso a los demás usuarios a la información del cliente cuando sea necesario. Por ejemplo, un comercial puede decidir compartir una oportunidad con otro comercial de forma que ambos puedan realizar un seguimiento del progreso de una venta importante.

Para compartir un registro, use la clase GrantAccessRequest. Use la clase ModifyAccessRequest para cambiar la forma en que se comparte un registro. Para eliminar el uso compartido de un registro, use la clase RevokeAccessRequest.

Un usuario debe tener derechos de uso compartido para poder compartir registros relacionados con los clientes, como contactos, cuentas, oportunidades, casos y pedidos, con cualquier otro usuario de Microsoft Dynamics 365. Cuando se comparte un registro, se pueden especificar los derechos que se van a conceder para el registro compartido.

En la siguiente lista se describen las reglas para compartir registros:

• Cualquier usuario con privilegios para compartir un registro puede compartirlo con otros usuarios o equipos.

• Cualquier usuario con privilegios para compartir un registro puede establecer los derechos de acceso del registro. Estos derechos de acceso controlan el acceso que un usuario que comparte un registro puede tener a ese registro.

• El acceso de un registro compartido se puede establecer en cualquier derecho de acceso, como por ejemplo, lectura o escritura.

• Los derechos de acceso de un registro compartido pueden ser distintos para cada usuario con el que se comparte el registro.

• Un registro solo se puede compartir una vez con la misma entidad de seguridad. Un usuario puede compartir un registro si tiene privilegios de compartir ese registro.

• Cualquier usuario con privilegios para compartir un registro empresarial puede modificar los derechos de acceso de los usuarios que han compartido el registro.

• Cualquier usuario con privilegios para compartir un registro empresarial puede quitar el uso compartido para un usuario determinado con el que ha compartido el registro.

• Cualquier usuario con privilegios para compartir un registro empresarial puede quitar el uso compartido para todos los usuarios con los que ha compartido el registro previamente.

Asociar

Para llevar a cabo esta acción, el autor de la llamada debe tener Associate message privileges y derechos de acceso a los registros que se van a actualizar.

La asociación crea varias asociaciones en una transacción entre el registro especificado y cada registro de la recopilación especificada para la relación especificada.

Para una relación de uno a varios, este método establece la propiedad ReferencingAttribute del registro relacionado en el identificador del registro especificado.

Para una relación de varios a varios, este método crea un registro en la tabla de intersección de la relación, que contiene los identificadores de los registros a los que se hace referencia y que hacen referencia. El nombre de la tabla de intersección se define en la propiedad IntersectEntityName de la relación.

Desasociar

Para llevar a cabo esta acción, el autor de la llamada debe tener Disassociate message privileges y derechos de acceso a los registros que se van a actualizar.

La desasociación anula la operación de asociación actualizando los registros a los que se hace referencia y que hacen referencia y eliminando el registro de intersección cuando sea necesario. Para obtener más información, vea Asociar.

Establecer estado

Para llevar a cabo esta acción, el autor de la llamada debe tener SetState message privileges y derechos de acceso a los registros que se van a actualizar. El mensaje SetStateRequest actualiza los atributos StateCode y StatusCode del registro de entidad.

Propiedad de la entidad

Existen varios tipos de propiedad de la entidad. La mayoría de las entidades, incluidas las entidades personalizadas, pertenecen a la organización, a un usuario o a un equipo. Hay algunas entidades de negocios que no tienen un propietario, como el tipo de descuento (lista de descuentos), donde la propiedad se define mediante la entidad de descuento primaria. El tipo de propiedad define algunas de las operaciones que se pueden realizar en un registro. La propiedad de una entidad se define en la propiedad de metadatos OwnershipType. La tabla siguiente enumera las propiedades relacionadas con la propiedad.

Información adicional sobre la propiedad del usuario o del equipo

Puede usar el mensaje AssignRequest para cambiar la propiedad de un registro. Para obtener más información, vea Asignar. Puede usar el mensaje ReassignObjectsOwnerRequest o ReassignObjectsSystemUserRequest para realizar la reasignación masiva de todos los registros de un propietario.

Estado y razón para el estado de los registros

La mayoría de las entidades de negocios tienen dos propiedades para realizar un seguimiento del estado de un registro. Son StateCode, que se denomina Estado en la aplicación web y StatusCode, que se denomina Razón para el estado en la aplicación web. Los valores de los atributos StateCode y StatusCode están vinculados. El atributo StateCode se usa internamente para representar el estado de la entidad. El atributo StatusCode se usa para mostrar este valor al usuario final. El conjunto de los códigos de estado válidos para una entidad no se puede personalizar, pero los códigos de la razón para el estado sí se pueden personalizar. Para la entidad de caso y las entidades personalizadas, puede definir criterios adicionales para transiciones válidas entre estados. Para obtener más información, vea Personalizar metadatos de atributos de entidad y Definir transiciones de modelo de estado personalizadas.

Imágenes de entidad

Determinadas entidades del sistema tienen atributos de imagen. Puede agregar atributos de imagen a las entidades personalizadas. Cuando una entidad tiene un atributo de imagen, puede establecer la propiedad PrimaryImageAttribute para controlar si la imagen se mostrará en la aplicación. Cuando la imagen se muestra en la aplicación, los usuarios de la aplicación web pueden cargar imágenes para el registro de entidad. Las siguientes entidades del sistema tienen atributos de imagen. Las que están marcadas con un asterisco están activadas de forma predeterminada para mostrarlas en la aplicación.

Más información:Atributos de datos de imagen.

Ver también

Entidades de administración y seguridad
Usar metadatos para generar diagramas de entidad
Definir transiciones de modelo de estado personalizadas
Clave para diagramas de entidad
Modelar los datos profesionales en Microsoft Dynamics 365
Personalizar metadatos de relación de entidad
Comportamiento de relación de entidades
Modelos de datos y metadatos en Microsoft Dynamics 365
Usar el servicio de la organización con metadatos de Dynamics 365
Empaquetar y distribuir las extensiones con soluciones
entidades de servicio de organización
El modelo de seguridad de Microsoft Dynamics 365
Ejemplo: establecer y recuperar imágenes de entidad
Ejemplo: asignar un registro a un equipo
Ejemplo: compartir registros utilizando los mensajes GrantAccess, ModifyAccess y RevokeAccess
Ejemplo: combinar dos registros
Ejemplo: validar el estado del registro y establecer el estado del registro
Ejemplo: registros consolidados relacionados con un registro específico

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright