Compartir a través de


Consideraciones de API de tablas virtuales

Hay dos grandes categorías de cambios en el sistema de definición de tablas que están asociadas con la introducción de tablas virtuales (también denominadas entidades virtuales) en Microsoft Dataverse:

  • Adición de un nuevo ensamblado, espacios de nombres, clases y otros tipos para admitir el desarrollo de proveedores de datos de tabla virtuales personalizados
  • Cambios a la plataforma principal, incluidas algunas propiedades adicionales para admitir la asignación de origen de datos externos y modificación de comportamientos de propiedades de tabla y columna existentes que reflejan las limitaciones de la implementación inicial de esta característica

Ensamblado de SDK de datos de Dynamics 365

El ensamblado de SDK de datos de Dynamics 365, Microsoft.Xrm.Sdk.Data.dll, contiene tipos que le ayudarán en la creación de proveedores de datos de tabla virtuales personalizados. Consta de los siguientes espacios de nombres:

Espacio de nombres Descripción
Microsoft.Xrm.Sdk.Data Espacio de nombres base que contiene algunos tipos comunes, como la enumeración AllowedQueryOptions
Microsoft.Xrm.Sdk.Data.CodeGen Contiene clases e interfaces que admiten reflexión dinámica, correspondencia de tipos y generación de código. Utilizado principalmente por el motor del proveedor interno.
Microsoft.Xrm.Sdk.Data.Converters Un conjunto de clases para convertir a tipos XRM estándar a sus correspondientes tipos fundamentales de .NET
Microsoft.Xrm.Sdk.Data.Exceptions Un conjunto de clases de excepciones que representan errores que se pueden producir durante la resolución del valor de ejecución. Todos se derivan de Microsoft.Xrm.Sdk.SdkExceptionBase.
Microsoft.Xrm.Sdk.Data.Expressions Clases para ayudar en la implementación de las transformaciones de consultas admitidas como FILTER, JOIN y ORDER.
Microsoft.Xrm.Sdk.Data.Mappings Clases e interfaces que crean la asignación de tipos de definición de tablas virtuales a tipos externos.
Microsoft.Xrm.Sdk.Data.Visitors Clases que implementan el patrón de visitantes para realizar operaciones específicas en el parámetro QueryExpression que se pasa al proveedor de datos durante las solicitudes RetrieveMultiple. Proporciona compatibilidad específica tanto para consulta genérica como para procesamiento basado en LINQ. Estas clases se derivan de Microsoft.Xrm.Sdk.Query.QueryExpressionVisitorBase.

Este ensamblado se distribuye como paquete de NuGet: Microsoft.CrmSdk.Data

Cambios en la plataforma principal

Los siguientes cambios a los tipos de referencia de Dataverse estándar se introdujeron para poder admitir tablas virtuales.

Nuevas tablas

Dataverse expone fuentes y proveedores de datos de tablas virtuales como las siguientes tablas: EntityDataProvider y EntityDataSource.

Nuevas propiedades de definición de tabla

Se agregaron cuatro nuevas propiedades a la clase EntityMetadata:

Propiedad Descripción
DataProviderId GUID que identifica el proveedor de datos de tabla virtual asociado
DataSourceId GUID que identifica el origen de datos de tabla virtual asociado
ExternalName Nombre de este tipo en el origen de datos externos
ExternalCollectionName Nombre plural para este tipo, que se usa en la interfaz de usuario y para admitir el acceso a OData

Se agregaron dos nuevas propiedades a la clase AttributeMetadata:

Propiedad Descripción
ExternalName Nombre del tipo en el origen de datos externos
IsDataSourceSecret Indica si el campo contiene información confidencial

La propiedad ExternalName también se agregó a las clases OptionMetadata y OptionSetMetadata. Estos nombres externos ayudan en la asignación de orígenes de datos externos, especificando el nombre del tipo asociado en el origen de datos externos. Estas propiedades solo se usan para tablas virtuales; para un tipo de entidad personalizada estándar o integrada, estos nombres externos deben ser null.

creación de tabla virtual

El método para crear mediante programación un tipo de tabla virtual difiere ligeramente de la creación de un tipo de entidad personalizada estándar en que:

  • Si el proveedor de datos asociados (y, opcionalmente, el origen de datos) se conoce en el momento de la creación, entonces se debe especificar.
  • Si no se conoce el proveedor de datos para este tipo, entonces, como mínimo, DataProviderId se establece en 7015A531-CC0D-4537-B5F2-C882A1EB65AD y DataSourceId se establece en null. Antes de que las instancias de este tipo se usen en tiempo de ejecución, se deben asignar valores adecuados a estas propiedades.

Dos nuevas tablas, EntityDataProvider y opcionalmente EntityDataSource, se crearán al registrar un complemento y sus respectivos ID, entitydataproviderid y entitydatasourceid, representan estos GUID obligatorios. (De lo contrario, los desarrolladores rara vez necesitan obtener acceso a estos tipos personalizados directamente). Tenga en cuenta que DataSource contiene la propiedad entitydataproviderid que debe coincidir con el tipo DataProvider correspondiente o se iniciará un excepción de tiempo de ejecución.

Advertencia

Las tablas (no virtuales) estándar deben tener los valores de sus entidades asociadas DataProviderId y DataSourceId establecidos en los valores predeterminados (null), de lo contrario se producirá una excepción de tiempo de ejecución. Una vez creado, no puede convertir un tipo no virtual en un tipo virtual, ni viceversa.

Cambios en el comportamiento de la propiedad de definición de tabla

La tabla siguiente muestra cómo se modifica el comportamiento de las propiedades de EntityMetadata estándar cuando se aplican a tablas virtuales. Algunas propiedades no son válidas para tablas virtuales, mientras que otras están limitadas en el ámbito o el valor.

Propiedad de metadatos ¿Se aplica? Notas
ActivityTypeMask no válido Siempre 0
Atributos válido
AutoCreateAccessTeams no válido Siempre false
AutoRouteToOwnerQueue no válido Siempre false, no se admiten las colas.
CanBeInManyToMany válido
CanBePrimaryEntityInRelationship válido
CanBeRelatedEntityInRelationship válido
CanChangeHierarchicalRelationship no válido Siempre false, no se admiten relaciones jerárquicas.
CanChangeTrackingBeEnabled no válido Siempre false, no se admiten valores de auditoría y seguimiento de cambios.
CanCreateAttributes válido
CanCreateCharts no válido Siempre false
CanCreateForms válido
CanCreateViews válido
CanEnableSyncToExternalSearchIndex no válido Siempre false
CanModifyAdditionalSettings válido
CanTriggerWorkflow no válido Siempre false, no se pueden desencadenar flujos de trabajo.
ChangeTrackingEnabled no válido Siempre false
CollectionSchemaName válido
DaysSinceRecordLastModified no válido Siempre nulo o 0
Descripción válido
DisplayCollectionName válido
DisplayName válido
EnforceStateTransitions no válido No se admiten StateCode y Status.
EntityColor válido
EntityHelpUrl válido
EntityHelpUrlEnabled válido
EntitySetName válido
ExtensionData no válido Propiedad obsoleta
HasChanged válido
IconLargeName válido
IconMediumName válido
IconSmallName válido
IntroducedVersion válido
IsActivity no válido Siempre false, no se admiten actividades.
IsActivityParty no válido Siempre false
IsAIRUpdated no válido Obsoleto
IsAuditEnabled no válido Siempre false, no se admite la auditoría.
IsAvailableOffline no válido Siempre false, no se admite el uso sin conexión.
IsBusinessProcessEnabled no válido Siempre false, no se admiten procesos de negocio.
IsChildEntity no válido Siempre false, todas las tablas virtuales son propiedad de la organización.
IsConnectionsEnabled válido
IsCustomEntity válido
IsCustomizable válido
IsDocumentManagementEnabled válido
IsDocumentRecommendationsEnabled no válido Siempre false, no se admite esta característica nueva.
IsDuplicateDetectionEnabled no válido Siempre false, pero la detección de duplicados se puede realizar en el origen de datos.
IsEnabledForCharts limitado Solo para cláusulas de Fetch admitidas.
IsEnabledForTrace válido
IsImportable válido
IsInteractionCentricEnabled válido
IsIntersect válido
IsKnowledgeManagementEnabled no válido Siempre false, no se admite la integración de la administración del conocimiento.
IsMailMergeEnabled válido
IsManaged válido
IsMappable válido
IsOfflineInMobileClient no válido Siempre false, los valores de la tabla virtual no se almacenan en caché para su uso sin conexión.
IsOneNoteIntegrationEnabled válido
IsOptimisticConcurrencyEnabled no válido Siempre false, la simultaneidad se debe implementar en el origen de datos.
IsPrivate válido
IsQuickCreateEnabled válido
IsReadOnlyInMobileClient válido
IsRenameable válido
IsSLAEnabled no válido Siempre false
IsStateModelAware no válido
IsValidForAdvancedFind válido
IsValidForQueue válido
IsVisibleInMobile válido
IsVisibleInMobileClient válido
Claves no válido No se admiten claves alternativas.
LogicalCollectionName válido
LogicalName válido
ManyToManyRelationships válido
ManyToOneRelationships válido No se admite entre dos tablas virtuales.
MetadataId válido
MobileOfflineFilters no válido Siempre false, no se admite el uso sin conexión.
CódigoDeTipoDeObjeto válido
OneToManyRelationships válido
OwnershipType no válido Siempre OrganizationOwned
PrimaryIdAttribute válido
PrimaryImageAttribute válido
PrimaryNameAttribute válido
Privilegios no válido
RecurrenceBaseEntityLogicalName no válido
ReportViewName no válido
SchemaName válido
SyncToExternalSearchIndex no válido

Cambios en el comportamiento de la propiedad de definición de columna

La tabla siguiente explica cómo se modifica el comportamiento de las propiedades de AttributeMetadata estándar cuando se aplican a tablas virtuales. Algunas propiedades no son válidas para tablas virtuales, mientras que otras están limitadas en el ámbito o el valor.

Propiedad de metadatos ¿Se aplica? Notas
ColumnNumber no válido
DeprecatedVersion válido
Descripción válido
DisplayName válido
EntityLogicalName válido
ExtensionData no válido
HasChanged válido
InheritsFrom válido
IntroducedVersion válido
IsAuditEnabled no válido Siempre false, no se admite la auditoría.
IsCustomAttribute válido
IsCustomizable válido
IsFilterable válido
IsGlobalFilterEnabled válido
IsLogical válido
IsManaged válido
IsPrimaryId válido
IsPrimaryName válido
IsRenameable válido
IsSearchable válido
IsSecured no válido Siempre false, no se admite la seguridad de nivel de campo.
IsSortableEnabled válido
IsValidForAdvancedFind válido
IsValidForCreate válido
IsValidForRead válido
IsValidForUpdate válido
LinkedAttributeId válido
LogicalName válido
MetadataId válido
RequiredLevel válido
SchemaName válido
SourceType no válido Siempre 0, no se admiten valores calculados o de resumen.

Consultar también

Introducción a las entidades virtuales
Proveedores de datos de tablas virtuales personalizadas
Ejemplo: Complemento de proveedor de datos de tabla virtual genérico

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).