Compartir a través de


Personalizar metadatos de entidad

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

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:

  • EntityMetadata.LogicalName: nombre que es la versión del nombre de la entidad que se establece en letras minúsculas.

  • EntityMetadata.SchemaName: nombre que se usará para crear las tablas de base de datos de la entidad. Este nombre puede incluir mayúsculas y minúsculas. El tipo de letra usado establece el nombre del objeto generado para la programación con establecimiento inflexible de tipos o cuando se utiliza el extremo REST.

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 Propiedad de la entidad.

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 Imágenes de entidad.

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 CRM 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

> [!NOTE] >

La propiedad EntityMetadata.IsReadingPaneEnabled es Solo para uso interno.

Para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics CRM 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 CRM para teléfonos

Use EntityMetadata.IsVisibleInMobile para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics CRM para teléfonos de ver los datos de esta entidad.

CRM para tabletas

Use EntityMetadata.IsVisibleInMobileClient para habilitar o deshabilitar la capacidad de los usuarios de Microsoft Dynamics CRM para tabletas de ver los datos de esta entidad.

Si la entidad está disponible para CRM 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

CreateEntityRequest

Crea una entidad personalizada.

DeleteEntityRequest

Elimina una entidad personalizada.

RetrieveAllEntitiesRequest

Recupera los metadatos para todas las entidades.

RetrieveEntityRequest

Recupera los metadatos para una entidad.

UpdateEntityRequest

Actualiza los metadatos para una entidad.

RetrieveMetadataChangesRequest

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 Acciones en los registros de la entidad.

Ver también

Ampliar el modelo de metadatos
Introducción a entidades en Microsoft Dynamics CRM 2015
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

© 2017 Microsoft. Todos los derechos reservados. Copyright