Compartir vía

Personalizar definiciones de tablas

  • Artículo

Definiendo o cambiando estas definiciones de tabla, puede controlar las capacidades de una tabla. Para ver las definiciones de tablas de su entorno, use el explorador de metadatos. Examinar las definiciones de tablas en su entorno.

Más información: Examinar las definiciones de tablas de su entorno

En este artículo se explica cómo trabajar con tablas mediante programación. Para trabajar con tablas en Power Apps, vea Tablas en Dataverse.

Se pueden crear tablas con SDK para .NET o la API web. La siguiente información se puede aplicar a ambos.

Operaciones de definiciones de tabla

Cómo trabajar con las definiciones de tabla depende del servicio que utilice.

Dado que la API web es un extremo RESTful, usa una forma diferente para crear, recuperar, actualizar y eliminar definiciones de tabla. Utilice los verbos HTTP POST, GET, PUT y DELETE para trabajar con tipos de entidad de definiciones de tabla. Aprenda a crear y actualizar definiciones de tabla mediante la API web

Una excepción es RetrieveMetadataChanges Function, que proporciona una forma de crear una consulta de definiciones de tabla y seguir los cambios a lo largo del tiempo.

Si trabaja con el SDK para .NET, utilice la clase RetrieveMetadataChangesRequest. Esta clase contiene los datos necesarios para recuperar una colección de definiciones de tabla que satisfaga los criterios especificados. RetrieveMetadataChangesResponse devuelve un valor de marca de tiempo que puede usar con esta solicitud en un momento posterior para obtener información sobre cómo han cambiado las definiciones de tabla desde la última solicitud.

Publicación API Web Ensamblado del SDK
CreateEntity Use una solicitud POST para enviar datos para crear una tabla. CreateEntityRequest
DeleteEntity Use una solicitud DELETE para eliminar una tabla. DeleteEntityRequest
RetrieveAllEntities Use una solicitud GET para recuperar datos de tabla. RetrieveAllEntitiesRequest
RetrieveEntity RetrieveEntity Function RetrieveEntityRequest
UpdateEntity Use una solicitud PUT para actualizar una tabla. UpdateEntityRequest
RetrieveMetadataChanges
Se usa junto objetos en el espacio de nombres Microsoft.Xrm.Sdk.Metadata.Query para crear una consulta para recuperar y detectar con eficiencia cambios en definiciones de tabla específicas. Más información: Recuperar y detectar cambios en las definiciones de tabla.		 RetrieveMetadataChanges Function RetrieveMetadataChangesRequest

Opciones disponibles cuando se crea una tabla personalizada

La siguiente lista enumera las opciones disponibles cuando se crea una tabla personalizada. Solo se pueden establecer estas propiedades al crear una tabla personalizada.

Opción Descripción
Crear como actividad personalizada Puede crear una tabla que sea una actividad asignándole la propiedad IsActivity al usar el SDK para .NET o la API web, respectivamente. Para obtener más información, consulte Personalizar actividades en Dynamics 365.
Nombres de tabla Existen dos tipos de nombres, y ambos deben tener un prefijo de personalización:

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

SchemaName: nombre que se usa para crear las tablas de base de datos. 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 tabla 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 tabla 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 empezar con mscrm. Se recomienda usar el prefijo de personalización definido por el editor con el que está asociada la solución, pero este procedimiento recomendado no es 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 OwnershipType para establecer cómo se poseen los registros de la tabla. Use la enumeración OwnershipTypes o el EnumType OwnershipTypes para establecer el tipo de propiedad de la tabla. Los únicos valores válidos para tablas personalizadas son OrgOwned o UserOwned. Para obtener más información, consulte Propiedad de tabla.
Columna principal Con el SDK para .NET, use CreateEntityRequest.PrimaryAttribute propiedad para establecer la columna principal.

Con la API web, el JSON que define la tabla debe incluir StringAttributeMetadata con la propiedad IsPrimaryName establecida en verdadero.

En ambos casos, la columna de cadena debe tener el formato Text. El valor de la columna principal es el que aparece en una búsqueda de tablas relacionadas. Por lo tanto, el valor de la columna debe representar un nombre para el registro.

Habilitar capacidades de tablas

La siguiente tabla enumera las capacidades de tablas. Puede configurar estas capacidades al crear una tabla o puede habilitarlas más adelante. Una vez habilitadas, estas capacidades no se pueden deshabilitar.

Funcionalidad Descripción
Flujos de proceso de negocio Establezca IsBusinessProcessEnabled como verdadero para habilitar la tabla para los flujos de proceso de negocio.
Notas Para crear una relación con la tabla Annotation y habilitar la inclusión de un área Notas en el formulario. Al incluir Notas, también puede agregar datos adjuntos a los registros.

Con el SDK para .NET, utilice la propiedad CreateEntityRequest o UpdateEntityRequest HasNotes

Con la API web, establezca la propiedad EntityMetadata.HasNotes .
Actividades Para crear una relación con la tabla ActivityPointer para que todas las tablas de tipo de actividad se puedan asociar con esta tabla.

Con el SDK para .NET, utilice la propiedad CreateEntityRequest o UpdateEntityRequest HasActivities.

Con la API web, establezca la propiedad EntityMetadata.HasActivities .
Conexiones Para habilitar la creación de registros de conexión para asociar esta tabla con otras tablas de conexión establezca el valor de la propiedad IsConnectionsEnabled.Value en verdadero.
Colas Use la propiedad IsValidForQueue para agregar compatibilidad para colas. Si habilita esta opción, también puede establecer la propiedad 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 IsActivityParty para poder enviar correo electrónico a una dirección de correo electrónico en este tipo de registro.

Propiedades de tablas editables

En la siguiente tabla se muestran las propiedades 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 IsQuickCreateEnabled para habilitar los formularios de creación rápida en la tabla. Para poder usar formularios de creación rápida primero debe crear y publicar uno.
Nota:
Las tablas de actividad no admiten formularios de creación rápida.
Equipos de acceso Use AutoCreateAccessTeams para habilitar la tabla para los equipos de acceso. Consulte Acerca de la colaboración con plantillas de equipo para obtener más información.
Imagen principal Si una tabla tiene una columna de imagen, puede habilitar o deshabilitar su visualización en la aplicación mediante PrimaryImageAttribute. Aprenda a trabajar con definiciones de columna de imagen mediante código
Cambiar texto para mostrar La propiedad administrada 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 DisplayName y DisplayCollectionName.
Editar la descripción de la tabla La propiedad administrada IsRenameable impide que se cambie la descripción de la tabla en la aplicación. Sin embargo, puede cambiar mediante programación las etiquetas actualizando la propiedad Description.
Habilitar su uso sin conexión Use IsAvailableOffline para habilitar o deshabilitar la capacidad de Dynamics 365 for Microsoft Office Outlook con usuarios sin conexión de acceso para desconectar los datos de esta tabla.
Habilitar el panel de lectura de Outlook Nota:

La propiedad IsReadingPaneEnabled es solo para uso interno.

Para habilitar o deshabilitar la capacidad de los usuarios de Office Outlook de ver los datos de esta tabla, use el panel de lectura de Outlook. Debe establecer esta propiedad en la aplicación.
Habilitar la combinación de correspondencia Use IsMailMergeEnabled para habilitar o deshabilitar la capacidad de generar documentos combinados de Office Word que usen datos de esta tabla.
Habilitar detección de duplicados Use IsDuplicateDetectionEnabled para habilitar o deshabilitar la detección de duplicados de la tabla. Para más información, vea Detectar datos duplicados usando código
Habilitar la integración de SharePoint Use IsDocumentManagementEnabled para habilitar o deshabilitar la integración del servidor de SharePoint para la tabla. Para obtener más información, consulte Habilitar administración de documentos de SharePoint para entidades específicas.
Habilitar Dynamics 365 for phones Use IsVisibleInMobile para habilitar o deshabilitar la capacidad de los usuarios de Dynamics 365 para teléfonos de ver los datos de esta tabla.
Dynamics 365 para tabletas Use IsVisibleInMobileClient para habilitar o deshabilitar la capacidad de los usuarios de Dynamics 365 para tabletas de ver los datos de esta tabla.

Si la tabla está disponible para Dynamics 365 para tabletas, puede usar IsReadOnlyInMobileClient para especificar que los datos del registro son de solo lectura.
Habilitar auditoría Use IsAuditEnabled para habilitar o deshabilitar la auditoría para la tabla. Para obtener más información, vea Configurar tablas y columnas para auditoría.
Cambiar áreas que muestran la tabla Puede controlar dónde aparecen las cuadrículas de tabla en el panel de navegación de la aplicación. Esto lo controla el mapa del sitio.
Agregar o quitar columnas Siempre que la propiedad administrada CanCreateAttributes.Value permita crear columnas, puede agregar columnas a la tabla. Para más información, vea Definiciones de columna.
Agregar o eliminar productos Siempre que la propiedad administrada CanCreateViews.Value permita crear vistas, puede usar la tabla SavedQuery para crear vistas para una tabla.
Agregar o eliminar gráficos Siempre que la propiedad administrada CanCreateCharts.Value permita la creación de gráficos y la propiedad de la entidad IsEnabledForCharts sea true, puede utilizar la Tabla SavedQueryVisualization para crear gráficos para una tabla. Para obtener más información, consulte Ver los datos con visualizaciones (gráficos).
Agregar o eliminar relaciones entre tablas Hay varias propiedades administradas que controlan los tipos de relaciones entre tablas que puede crear para una tabla. Para obtener más información, consulte Definiciones de relaciones de tabla.
Cambiar iconos Puede cambiar los iconos usados para tablas personalizadas. Para más información, consulte Cambiar iconos de tabla personalizados de la aplicación basada en modelos
Puede cambiar la relación jerárquica CanChangeHierarchicalRelationship.Value controla si el estado jerárquico de las relaciones incluido en sus soluciones administradas se puede cambiar.
Nombre del conjunto de entidades EntitySetName especifica el nombre utilizado para identificar de forma exclusiva la tabla utilizando API Web de Dataverse. Esto suele ser lo mismo que el LogicalCollectionName, pero no puede cambiar el LogicalCollectionName. Solo debe cambiar EntitySetName antes de escribir cualquier código utilizando el nombre del conjunto de entidades predeterminado. Más información sobre establecer nombres de entidad

Mensajes admitidos por las tablas personalizadas

Las tablas personalizadas admiten los mismos mensajes base que las tablas del sistema. El conjunto de mensajes disponible depende de si la tabla personalizada es propiedad del usuario o de la organización. Las tablas propiedad del usuario admiten el uso compartido, por lo que mensajes como GrantAccess, ModifyAccess y RevokeAccess están disponibles.

Consulte también

Utilizar la API web con definiciones de tabla
Trabajar con definiciones de tablas mediante SDK para .NET

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).