Personalizar metadatos de entidad
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Las entidades están definidas por metadatos. Definiendo o cambiando estos metadatos, puede controlar las capacidades de una entidad. Para ver los metadatos de su organización, use el explorador de metadatos proporcionado en el paquete del SDK. Descargue el paquete de SDK de Microsoft Dynamics CRM. Más información:Examinar los metadatos de la organización
En este tema se explica cómo trabajar con entidades mediante programación. Consulte TechNet: Creación y edición de entidades para obtener información sobre cómo trabajar con entidades en la aplicación.
En este tema
Opciones disponibles cuando se crea una entidad personalizada
Habilitación de capacidades de entidad
Propiedades de entidad editables
Mensajes de metadatos de la entidad
Mensajes admitidos por las entidades personalizadas
Opciones disponibles cuando se crea una entidad personalizada
La siguiente tabla muestra las opciones disponibles cuando se crea una entidad personalizada. Solo se pueden establecer estas propiedades al crear una entidad personalizada.
Opción |
Descripción |
|---|---|
Crear como actividad personalizada |
Puede crear una entidad que sea una actividad estableciendo la propiedad EntityMetadata.IsActivity. Para obtener más información, vea Actividades personalizadas. |
Nombres de entidad |
Existen dos tipos de nombres, y ambos deben tener un prefijo de personalización:
Nota Si el nombre lógico es distinto del nombre de esquema, este reemplazará el valor que se estableció para el nombre lógico. Cuando se crea una entidad en la aplicación en el contexto de una solución específica, el prefijo de personalización usado es el establecido para el Publisher de la solución. Cuando se crea una entidad mediante programación, se puede establecer el prefijo de personalización en una cadena que tenga entre dos y ocho caracteres de longitud, todos alfanuméricos, y que empiece por una letra. No puede comenzar por “mscrm”. Se recomienda usar el prefijo de personalización definido por el editor con el que está asociada la solución, pero no es un requisito obligatorio. Se debe incluir un carácter de subrayado entre el prefijo de personalización y el nombre de esquema o nombre lógico. |
Propiedad |
Use la propiedad EntityMetadata.OwnershipType para establecer este valor. Use la enumeración OwnershipTypes para establecer el tipo de propiedad de la entidad. Los únicos valores válidos para entidades personalizadas son OrgOwned o UserOwned. Para obtener más información, vea 8597998f-764f-4c73-b63d-9f5e02c78061#EntityOwnership. |
Atributo principal |
Use CreateEntityRequest.PrimaryAttribute para establecer este valor. Cada entidad tiene un atributo StringAttributeMetadata que usa StringFormat.Text como el atributo principal. El valor de este atributo es el que aparece en una búsqueda de entidades relacionadas. Por lo tanto, el valor del campo debe representar un nombre para el registro de entidad. |
Habilitación de capacidades de entidad
La siguiente tabla muestra las capacidades de entidad. Puede configurar estas capacidades al crear una entidad o puede habilitarlas más adelante. Una vez habilitadas, estas capacidades no se pueden deshabilitar.
Capacidad |
Descripción |
|---|---|
Flujos de proceso de negocio |
Defina los EntityMetadata.IsBusinessProcessEnabled como true para habilitar la entidad para los flujos de proceso de negocio. |
Notas |
Use la propiedad CreateEntityRequest o UpdateEntityRequest.HasNotes para crear una relación entre entidades con la entidad Annotation y habilitar la inclusión de un área Notes en el formulario de entidad. Al incluir Notas, también puede agregar datos adjuntos a los registros. |
Actividades |
Use la propiedad CreateEntityRequest o UpdateEntityRequest.HasActivities para crear una relación entre entidades con la entidad ActivityPointer para que todas las entidades de tipo de actividad se puedan asociar con esta entidad. |
Conexiones |
Establezca la propiedad EntityMetadata.IsConnectionsEnabled para habilitar la creación de registros de conexión para asociar esta entidad con otras entidades de conexión. |
Colas |
Use la propiedad EntityMetadata.IsValidForQueue para agregar compatibilidad para colas. Cuando se habilita esta opción, también se puede establecer la propiedad EntityMetadata.AutoRouteToOwnerQueue para mover automáticamente registros a la cola predeterminada del propietario cuando se crea o asigna un registro de este tipo. |
Correo electrónico |
Establezca la propiedad EntityMetadata.IsActivityParty para poder enviar correo electrónico a una dirección de correo electrónico en este tipo de registro. |
Propiedades de entidad editables
En la siguiente tabla se muestran las propiedades de entidad que puede editar. A menos que una propiedad administrada deshabilite estas opciones, puede actualizarlas en cualquier momento.
Propiedad |
Descripción |
|---|---|
Permitir creación rápida |
Use EntityMetadata.IsQuickCreateEnabled para habilitar los formularios de creación rápida en la entidad. Para poder usar formularios de creación rápida primero debe crear y publicar uno. Nota Las entidades de actividad no admiten formularios de creación rápida. |
Equipos de acceso |
Use EntityMetadata.AutoCreateAccessTeams para habilitar la entidad para los equipos de acceso. Consulte Ayuda y entrenamiento: Acerca de las plantillas de equipopara obtener más información. |
Imagen principal |
Si una entidad tiene un atributo de imagen, puede habilitar o deshabilitar su visualización en la aplicación mediante PrimaryImageAttribute. Para obtener más información, vea 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages. |
Cambiar texto para mostrar |
La propiedad administrada EntityMetadata.IsRenameable impide que se cambie el nombre para mostrar en la aplicación. Sin embargo, puede cambiar mediante programación las etiquetas actualizando las propiedades EntityMetadata.DisplayName y EntityMetadata.DisplayCollectionName. |
Editar la descripción de la entidad |
La propiedad administrada EntityMetadata.IsRenameable impide que se cambie la descripción de la entidad en la aplicación. Sin embargo, puede cambiar mediante programación las etiquetas actualizando la propiedad EntityMetadata.Description. |
Habilitar su uso sin conexión |
Use EntityMetadata.IsAvailableOffline para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics 365 para Microsoft Office Outlook con acceso sin conexión de trabajar con los datos de esta entidad sin conexión. |
Habilitar el panel de lectura de Outlook |
Nota La propiedad EntityMetadata.IsReadingPaneEnabled es Sólo para uso interno. Para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics 365 para Outlook de ver los datos de esta entidad, use el panel de lectura de Microsoft Outlook. Debe establecer esta propiedad en la aplicación. |
Habilitar la combinación de correspondencia |
Use EntityMetadata.IsMailMergeEnabled para habilitar o deshabilitar la capacidad de generar documentos combinados de Microsoft Office Word que usen datos de esta entidad. |
Habilitar detección de duplicados |
Use EntityMetadata.IsDuplicateDetectionEnabled para habilitar o deshabilitar la detección de duplicados de la entidad. Para obtener más información, vea Detectar datos duplicados. |
Habilitar la integración de SharePoint |
Use EntityMetadata.IsDocumentManagementEnabled para habilitar o deshabilitar la integración de SharePoint Server para la entidad. Para obtener más información, vea Habilitar la administración de documentos para entidades. |
Habilitar Dynamics 365 para teléfonos |
Use EntityMetadata.IsVisibleInMobile para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics 365 para teléfonos de ver los datos de esta entidad. |
Dynamics 365 para tabletas |
Use EntityMetadata.IsVisibleInMobileClient para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics 365 para tabletas de ver los datos de esta entidad. Si la entidad está disponible para Dynamics 365 para tabletas puede usar EntityMetadata.IsReadOnlyInMobileClient para especificar que los datos del registro son de solo lectura. |
Habilitar auditoría |
Use EntityMetadata.IsAuditEnabled para habilitar o deshabilitar la auditoría para la entidad. Para obtener más información, vea Configurar entidades y atributos para auditoría. |
Cambiar áreas que muestran la entidad |
Puede controlar dónde aparecen las cuadrículas de entidad en el panel de navegación de la aplicación. Esto lo controla el mapa del sitio. Para obtener más información, vea Editar el mapa del sitio. |
Agregar o quitar atributos |
Siempre que la propiedad administrada EntityMetadata.CanCreateAttributes permita crear atributos, puede usar el mensaje CreateAttributeRequest para agregar atributos. Para obtener más información, vea Personalizar metadatos de atributos de entidad. |
Agregar o eliminar productos |
Siempre que la propiedad administrada EntityMetadata.CanCreateViews permita crear vistas, puede usar la entidad SavedQuery para crear vistas para una entidad. |
Agregar o eliminar gráficos |
Siempre que la propiedad administrada EntityMetadata.CanCreateCharts permita la creación de gráficos y la propiedad de la entidad EntityMetadata.IsEnabledForCharts sea true, puede utilizar SavedQueryVisualization para crear gráficos para una entidad. Para obtener más información, vea Ver los datos con visualizaciones (gráficos). |
Agregar o eliminar relaciones entre entidades |
Hay varias propiedades administradas que controlan los tipos de relaciones entre entidades que puede crear para una entidad. Para obtener más información, vea Personalizar metadatos de relación de entidad. |
Cambiar iconos |
Puede cambiar los iconos usados para entidades personalizadas. Para obtener más información, vea Modificar los iconos para una entidad. |
Use Ayuda personalizada |
EntityMetadata.EntityHelpUrlEnabled controla si hay ayuda personalizada habilitada para la entidad.Más información:Agregue el contenido personalizado de ayuda. |
URL de ayuda |
EntityMetadata.EntityHelpUrl controla qué recursos se muestran para contenido de ayuda para la entidad si está habilitada la ayuda personalizada.Más información:Agregue el contenido personalizado de ayuda. |
Puede cambiar la relación jerárquica |
EntityMetadata.CanChangeHierarchicalRelationship controla si el estado jerárquico de las relaciones entre entidades incluido en sus soluciones administradas se puede cambiar.Más información: |
Mensajes de metadatos de la entidad
La siguiente tabla muestra los mensajes que puede usar para crear, recuperar, actualizar y eliminar metadatos de la entidad.
Nombre del mensaje |
Descripción |
|---|---|
Crea una entidad personalizada. |
|
Elimina una entidad personalizada. |
|
Recupera los metadatos para todas las entidades. |
|
Recupera los metadatos para una entidad. |
|
Actualiza los metadatos para una entidad. |
|
Se usa junto objetos en el espacio de nombres de Microsoft.Xrm.Sdk.Metadata.Query para crear una consulta para recuperar y detectar con eficiencia cambios en metadatos específicos.Más información:Recuperar y detectar cambios en metadatos. |
Mensajes admitidos por las entidades personalizadas
Las entidades personalizadas admiten los mismos mensajes base que las entidades del sistema. El conjunto de mensajes disponible depende de si la entidad personalizada es propiedad del usuario o de la organización. Para obtener más información, vea 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords.
Ver también
Usar el servicio de la organización con metadatos de Dynamics 365
Introducción a entidades en Microsoft Dynamics 365
Examinar los metadatos de la organización
Personalizar metadatos de atributos de entidad
Personalizar metadatos de relación de entidad
Detectar datos duplicados
Habilitar la administración de documentos para entidades
Configurar entidades y atributos para auditoría
Editar el mapa del sitio
Ver los datos con visualizaciones (gráficos)
¿Qué entidades se pueden personalizar?
Crear una entidad personalizada
Recuperar, actualizar y eliminar entidades
Crear y actualizar una entidad que se puede enviar por correo electrónico
Crear una entidad de actividad personalizada
Modificar los iconos para una entidad
Modificar los mensajes de una entidad
Ejemplo: crear y actualizar metadatos de entidad
Ejemplo: crear entidades de actividad personalizada
Ejemplo: crear y actualizar una entidad que se puede enviar por correo electrónico
Ejemplo: volcar metadatos de entidad en un archivo
Ejemplo: volcar la información de privilegio de entidad en un archivo
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright