Crear asignaciones de datos para importar

Para importar datos a Microsoft Dataverse, debe proporcionar las asignaciones de datos adecuadas.

Puede descargar ejemplos de asignaciones de datos en Descargas de Microsoft: DataImportMaps.zip.

Se utilizan asignaciones de datos para asignar los datos contenidos en el archivo de origen a las columnas de tabla de Dataverse. Debe asignar cada columna del archivo de origen a una columna apropiada. Los datos de las columnas o los archivos sin asignar no se importan durante la importación de datos.

La asignación de datos se representa con la tabla Asignación de datos (ImportMap). Puede crear una nueva asignación creando nuevos registros de esta tabla. La asignación tiene un nombre único que se incluye en la columna ImportMap.Name. Puede especificar el nombre del origen de importación para el que la asignación de datos se crea mediante la columna ImportMap.Source.

Columna, valor de lista y asignaciones de la búsqueda

Para asignar una columna, un valor de lista o el valor de búsqueda del archivo de origen a una columna de Dataverse, use las siguientes asignaciones:

Asignación de columnas

Asigna una columna de un archivo de origen a una columna de Dataverse. Para asignaciones de columna, use la tabla ColumnMapping. Puede usar relaciones de 1:1 (uno a uno) o 1:N (uno a varios) entre las columnas de origen y de destino. Por ejemplo, puede asignar la información de dirección de una cuenta a las direcciones de facturación y envío de un pedido.

Asignación de valores de lista

Asigna un valor de lista de un archivo de origen a una columna de Dataverse del tipo OptionSetValue. Para la asignación de valores, use la tabla Asignación de valores de lista (PickListMapping).

Si un valor especificado en la columna del archivo de origen es un valor de lista, como un OptionSetValue, un estado y un booleano, debe proporcionar una asignación de valores de lista además de una asignación de columnas. Por ejemplo, asigne los valores de lista "cuenta" y "enviar" del archivo de origen a los valores de facturación y envío del tipo OptionSetValue.

Asignación de búsquedas

Asigna un valor de búsqueda de un archivo de origen a una columna de Dataverse del tipo EntityReference. Para asignaciones de búsqueda, use la tabla LookUpMapping.

Si el valor especificado en el archivo de origen hace referencia a una tabla, debe proporcionar una asignación de búsqueda para este valor. Use la columna LookupMapping.LookupSourceCode para especificar si buscar la tabla a la que se hace referencia en el archivo de origen o en Dataverse. Si usa enlaces en tiempo de compilación, puede usar la enumeración de LookupSourceType para establecer los valores de búsqueda. Para buscar en el archivo de origen, use el valor de LookupSourceType.Source. Para buscar en Dataverse, use el valor de LookupSourceType.System. Para obtener una lista de valores de LookupSourceCode, consulte los valores posibles para esta tabla. Para ver los metadatos de su organización, instale la solución Explorador de metadatos que se describe en Examinar las definiciones de tablas en su entorno. También puede examinar la documentación de referencia para las tablas en la Referencia de tabla. Puede proporcionar varias asignaciones de búsqueda. El trabajo de transformación asíncrona procesa todas las asignaciones disponibles. Encuentra los registros de referencia y actualiza la tabla de análisis con los identificadores únicos de registro. Para obtener más información, vea Ejecutar importación de datos.

Asignación de propietario

Use la asignación de propietario para asignar un usuario especificado en el archivo de origen a un usuario de Dataverse. Para obtener información de registro, use el nombre de inicio de sesión de Dataverse. Para asignaciones de propietario, use la tabla OwnerMapping.

Notas y datos adjuntos.

La asignación de notas y datos adjuntos se controla de forma diferente de otras tablas. Las notas y datos adjuntos se usan para anexar información adicional a un registro en Dataverse. Las notas se almacenan como texto y los datos adjuntos se almacenan como archivos en la base de datos de Dataverse.

Para crear una nota en Dataverse, establezca la columna Annotation.IsDocument en a tabla de anotación (nota) en false. Para crear datos adjuntos, establezca IsDocument en true.

Use la siguiente configuración para asignar notas y datos adjuntos:

• Establezca la columna ColumnMapping.SourceAttributeName en “true” o “false”. El valor de "true" indica datos adjuntos. El valor de "false" indica una nota.

• Establezca la columna ColumnMapping.TargetAttributeName en IsDocument.

• Establezca la columna ColumnMapping.ProcessCode en el valor ImportProcessCode.Internal de la enumeración ImportProcessCode, si está usando enlaces tempranos. Para obtener una lista de los valores de ProcessCode, consulte los valores posibles para esta tabla.

  Si los datos de origen representan una nota, asigne el texto de la nota a la columna Annotation.NoteText. Si está trabajando con los archivos de Salesforce, normalmente se almacenan en el disco en números de identificación únicos. Para importar un archivo adjunto, debe asignar un número de identificación del archivo que se incluye en el archivo de origen a la columna Annotation.DocumentBody. La columna DocumentBody almacena el contenido de los archivos adjuntos.

  El trabajo de importación asincrónico comprueba las asignaciones con el nombre de la columna de origen establecido en “true” y “false” para describir notas y archivos adjuntos. Si encuentra una asignación de datos adjuntos, busca los archivos especificados en el disco y carga el contenido del archivo como datos adjuntos en Dataverse. Si un archivo no se encuentra, se devuelve un error.

  Si no ofrece la asignación de una tabla de anotación (nota), el trabajo de importación genera una asignación predeterminada para la nota.

Nota

El tamaño máximo de los archivos que se pueden cargar se determina mediante la propiedad Organization.MaxUploadFileSize. Esta propiedad se define en la pestaña Correo electrónico de Configuración del sistema en la aplicación Dataverse. Esta configuración limita el tamaño de los archivos que pueden adjuntarse a los mensajes de correo electrónico, notas y recursos web. La configuración predeterminada es 5 MB. No obstante, el tamaño de los datos adjuntos no puede exceder el tamaño máximo solicitado (el valor predeterminado es 16 MB).

Asignaciones de datos de importación y exportación

Puede exportar una asignación de datos existente a un archivo XML e importar asignaciones de datos XML a Dataverse. Para exportar una asignación de datos de Dataverse, use el mensaje ExportMappingsImportMap usando ExportMappingsImportMapRequest Class o ExportMappingsImportMap Action. Para importar asignaciones de datos XML y crear una asignación de datos en Dataverse, use el mensaje ImportMappingsImportMap con ImportMappingsImportMapRequest Class o ImportMappingsImportMap Action.

Consulte también

Importar datos
Preparar archivos de origen para importar
Agregar asignaciones de transformación para la importación
Configurar la importación de datos
Ejecutar importación de datos
Tablas de importación de datos
Ejemplo: exportar e importar una asignación de datos
Ejemplo: importar datos mediante la asignación de datos complejos

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