Compartir por

Personalizar definiciones de tablas

Al definir o cambiar las definiciones de tabla, puede controlar las funcionalidades de una tabla. Para ver las definiciones de tabla de su entorno, use el explorador de metadatos. Examine las definiciones de tabla en su entorno.

Más información: Consultar definiciones de tabla para su entorno

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

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

Operaciones sobre definiciones de tablas

La forma de trabajar con definiciones de tabla depende del servicio que use.

Dado que la API web es un punto de conexión RESTful, usa una manera diferente de 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 a esto es la función RetrieveMetadataChanges proporciona una manera de crear consultas de definiciones de tabla y realizar un seguimiento de los cambios a lo largo del tiempo.

Si trabaja con el SDK para .NET, use la RetrieveMetadataChangesRequest clase. Esta clase contiene los datos necesarios para recuperar una colección de registros de definiciones de tabla que cumplen los criterios especificados. RetrieveMetadataChangesResponse devuelve un valor de marca de tiempo que se puede usar con esta solicitud más adelante para devolver información sobre cómo cambiaron las definiciones de tabla desde la última solicitud.

Message API de la 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 la solicitud GET para recuperar datos de tabla. RetrieveAllEntitiesRequest
RetrieveEntity Función RetrieveEntity RetrieveEntityRequest
UpdateEntity Use una solicitud PUT para actualizar una tabla. UpdateEntityRequest
RetrieveMetadataChanges
Se usa junto con objetos del Microsoft.Xrm.Sdk.Metadata.Query espacio de nombres para crear una consulta para recuperar y detectar cambios en definiciones de tabla específicas de forma eficaz. Más información: Recuperar y detectar cambios en las definiciones de tabla.		 Función RetrieveMetadataChanges RetrieveMetadataChangesRequest

Opciones disponibles al crear una tabla personalizada

A continuación se enumeran las opciones disponibles al crear una tabla personalizada. Solo puede establecer estas propiedades al crear una tabla personalizada.

Opción Description
Crear como actividad personalizada Puede crear una tabla que sea una actividad estableciendo la IsActivity propiedad al usar el SDK para .NET o la API web, respectivamente. Para más información, consulte Actividades personalizadas 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 usado 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 difiere del nombre del esquema, el nombre del esquema invalida el valor que 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 que se establece para la Publisher de la solución. Cuando se crea una tabla mediante programación, puede establecer el prefijo de personalización en una cadena que tenga entre dos y ocho caracteres de longitud, todos los caracteres alfanuméricos y deben comenzar con una letra. No puede empezar con mscrm. El procedimiento recomendado es usar el prefijo de personalización definido por el publicador al que está asociada la solución, pero este procedimiento recomendado no se aplica. 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 OwnershipType propiedad para establecer cómo pertenecen los registros de tabla. Use la OwnershipTypes enumeración o OwnershipTypes EnumType para establecer el tipo de propiedad de la tabla. Los únicos valores válidos para las tablas personalizadas son OrgOwned o UserOwned. Para obtener más información, vea Propiedad de la tabla.
Columna principal Con el SDK para .NET, use la propiedad CreateEntityRequestPrimaryAttribute para establecer la columna principal.

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

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

Habilitación de las funcionalidades de tabla

A continuación se enumeran las funcionalidades de la tabla. Puede establecer estas funcionalidades al crear una tabla o puede habilitarlas más adelante. Una vez habilitada, estas funcionalidades no se pueden deshabilitar.

Capacidad Description
Flujos de proceso de negocio Establezca IsBusinessProcessEnabled en verdadero para habilitar la tabla para los flujos de procesos empresariales.
Notas Para crear una relación con la Annotation tabla 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, use las propiedades CreateEntityRequest o UpdateEntityRequestHasNotes.

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

Con el SDK para .NET, use la propiedad CreateEntityRequest o UpdateEntityRequestHasActivities.

Con la API web, establezca la propiedad EntityMetadata. propiedad 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 propiedad IsConnectionsEnabled.Value en true.
Queues Use la propiedad IsValidForQueue para agregar compatibilidad para colas. Al habilitar esta opción, también puede establecer la AutoRouteToOwnerQueue propiedad para mover automáticamente los 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 tabla editables

A continuación se enumeran las propiedades de la tabla que puede editar. A menos que una propiedad administrada deshabilite estas opciones, puede actualizarlas en cualquier momento.

Propiedad Description
Permitir creación rápida Use IsQuickCreateEnabled para habilitar formularios de creación rápida para la tabla. Para poder usar formularios de creación rápida, primero debe crear y publicar un formulario de creación rápida.
Nota:
Las tablas de actividad no admiten formularios de creación rápida.
Acceder a Teams Use AutoCreateAccessTeams para habilitar la tabla para los equipos de acceso. Consulte Acerca de cómo colaborar con plantillas de equipo para obtener más información.
Imagen principal. Si una tabla tiene una columna de imagen, puede habilitar o deshabilitar la visualización de esa imagen en la aplicación mediante PrimaryImageAttribute. Aprenda a trabajar con definiciones de columnas 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 IsRenameable administrada impide que la descripción de la tabla se cambie en la aplicación. Sin embargo, puede cambiar mediante programación las etiquetas actualizando la propiedad Description.
Habilitar su uso sin conexión Usa IsAvailableOffline para habilitar o deshabilitar la capacidad de los usuarios de Dynamics 365 para Microsoft Office Outlook con Acceso sin conexión para usar los datos de esta tabla sin conexión.
Habilitar el panel de lectura de Outlook Nota:

La IsReadingPaneEnabled propiedad 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 usan datos de esta tabla.
Habilitar detección de duplicados Use IsDuplicateDetectionEnabled para habilitar o deshabilitar la detección de duplicados para la tabla. Para obtener más información, consulte Detección de datos duplicados mediante 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 para teléfonos Use IsVisibleInMobile para habilitar o deshabilitar la capacidad de Dynamics 365 para los usuarios de teléfonos para ver los datos de esta tabla.
Dynamics 365 para tabletas Use IsVisibleInMobileClient para habilitar o deshabilitar la capacidad de Dynamics 365 para los usuarios de tabletas para 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 de la tabla. Para obtener más información, consulte Configuración de 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 SiteMap.
Agregar o quitar columnas Siempre que la propiedad CanCreateAttributes.Value administrada permita crear columnas, puede agregar columnas a la tabla. Para obtener más información, vea Definiciones de columna.
Agregar o eliminar vistas Siempre que la propiedad CanCreateViews.Value administrada permita crear vistas, puede usar la SavedQuery tabla para crear vistas para una tabla.
Agregar o eliminar gráficos Siempre que la propiedad CanCreateCharts.Value administrada permita crear gráficos y la IsEnabledForCharts propiedad de la tabla sea verdadera, puede usar la tabla SavedQueryVisualization para crear gráficos para una tabla. Para obtener más información, consulte Visualización de datos con visualizaciones (gráficos).
Agregar o quitar relaciones de tabla Hay varias propiedades administradas que controlan los tipos de relaciones que puede crear para una tabla. Para obtener más información, vea Definiciones de relaciones de tabla.
Cambiar iconos Puede cambiar los iconos usados para las tablas personalizadas. Para obtener más información, consulte Cambio de iconos de tabla personalizada de aplicaciones controladas por modelos.
Puede cambiar la relación jerárquica CanChangeHierarchicalRelationship.Value controla si se puede cambiar el estado jerárquico de las relaciones incluidas en las soluciones administradas.
Nombre del conjunto de entidades EntitySetName especifica el nombre que se usa para identificar de forma única la tabla mediante la API web de Dataverse. Esto suele ser lo mismo que LogicalCollectionName, pero no puedes cambiar el LogicalCollectionName. Solo debe cambiar EntitySetName antes de que se escriba cualquier código con el nombre predeterminado del conjunto de entidades. Más información sobre los nombres de conjuntos de entidades

Mensajes soportados por tablas personalizadas

Las tablas personalizadas admiten los mismos mensajes base que las tablas del sistema. El conjunto de mensajes disponibles 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 hay mensajes como GrantAccess, ModifyAccessy RevokeAccess disponibles.

Consulte también

Uso de la API web con definiciones de tabla
Trabajar con definiciones de tabla mediante el SDK para .NET

  • Last updated on