Crear asignaciones de datos para importar
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Para importar datos a Microsoft Dynamics 365, debe proporcionar las asignaciones de datos adecuadas.
Los ejemplos de asignaciones de datos se pueden encontrar en esta ubicación en el SDK: SDK\Resources\DataImportMaps\.Descargue el paquete de SDK de Microsoft Dynamics CRM.
Se utilizan asignaciones de datos para asignar los datos contenidos en el archivo de origen a los atributos de entidad Microsoft Dynamics 365. Debe asignar cada columna del archivo de origen a un atributo apropiado. 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 entidad de asignación de importación (asignación de datos). Puede crear una nueva asignación mediante el mensaje de CreateRequest o actualizar una asignación existente mediante el método IOrganizationService.Update. La asignación tiene un nombre único que se incluye en el atributo de ImportMap.Name. Puede especificar el nombre del origen de importación para el que la asignación de datos se crea mediante el atributo de ImportMap.Source.
En este tema
Columna, valor de lista y asignaciones de la búsqueda
Asignación de propietario
Notas y datos adjuntos.
Asignaciones de datos de importación y exportación
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 un atributo de Microsoft Dynamics 365, use las siguientes asignaciones:
Asignación de columnas
Asigna una columna de un archivo de origen a un atributo de entidad de Microsoft Dynamics 365. Para asignaciones de columna, use la entidad de asignaciones de columna (ColumnMapping). Puede usar relaciones de 1:1 (uno a uno) o 1:N (uno a varios) entre los atributos 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 un atributo de Microsoft Dynamics 365 del tipo OptionSetValue. Para la asignación de valores de lista, use la entidad de asignación de lista desplegable (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 un atributo de Microsoft Dynamics 365 del tipo EntityReference. Para asignaciones de búsqueda, use la entidad de asignación de búsqueda (LookupMapping).
Si el valor especificado en el archivo de origen hace referencia a una entidad, debe proporcionar una asignación de búsqueda para este valor. Use el atributo de LookupMapping.LookupSourceCode para especificar si buscar la entidad a la que se hace referencia en el archivo de origen o en Microsoft Dynamics 365. 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 Microsoft Dynamics 365, use el valor de LookupSourceType.System. Para obtener una lista de valores de LookupSourceCode, consulte los valores de lista desplegable para esta entidad.Para ver los metadatos de la entidad de su organización, instale la solución Explorador de metadatos que se describe en Examinar los metadatos de la organización. También puede ver los metadatos de una organización no personalizada en una hoja de cálculo de Excel denominada EntityMetadata.xlsx que se incluye en la carpeta de nivel superior de la descarga del SDK. 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 Microsoft Dynamics 365. Para obtener información de registro, use el nombre de inicio de sesión de Microsoft Dynamics 365. Para asignaciones de propietario, use la entidad de asignación de propietario (OwnerMapping).
Notas y datos adjuntos.
La asignación de notas y datos adjuntos se controla de forma diferente de otras entidades. Las notas y datos adjuntos se usan para anexar información adicional a un registro en Microsoft Dynamics 365. Las notas se almacenan como texto y los datos adjuntos se almacenan como archivos en la base de datos de Microsoft Dynamics 365.
Para crear una nota en Microsoft Dynamics 365, establezca el atributo de Annotation.IsDocument de la entidad 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 el atributo ColumnMapping.SourceAttributeName en “true” o “false”. El valor de "true" indica datos adjuntos. El valor de "false" indica una nota.
Establezca el atributo ColumnMapping.TargetAttributeName en IsDocument.
Si usa enlaces en tiempo de compilación, establezca el atributo ColumnMapping.ProcessCode en el valor ImportProcessCode.Internal de la enumeración ImportProcessCode. Para obtener una lista de valores de ProcessCode, consulte los valores de lista desplegable para esta entidad.
Si los datos de origen representan una nota, asigne el texto de la nota al atributo de 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 datos adjuntos, debe asignar un número de identificación del archivo que se incluye en el archivo de origen al atributo de Annotation.DocumentBody. El atributo de DocumentBody almacena el contenido de los datos adjuntos.
El trabajo de importación asíncrono comprueba las asignaciones con el nombre del atributo de origen establecido en "true" y "false" para averiguar notas y datos 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 Microsoft Dynamics 365. Si un archivo no se encuentra, se devuelve un error.
Si no ofrece la asignación de una entidad 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 Dynamics 365. 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). Para que el cambio tenga efecto, restablezca Internet Information Services (IIS). Para ello, haga clic en Inicio, Ejecutar, escriba iisreset y, a continuación, haga clic en Aceptar.
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 Microsoft Dynamics 365. Para exportar una asignación de datos de Microsoft Dynamics 365, use el mensaje de ExportMappingsImportMapRequest. Para importar asignaciones de datos XML y crear una asignación de datos en Microsoft Dynamics 365, use el mensaje de ImportMappingsImportMapRequest.
Ver también
Importar datos
Agregar asignaciones de transformación para la importación
Agregar asignaciones de transformación para la importación
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright