Agregar asignaciones de transformación para la importación

Artículo
06/23/2023

Use la asignación de transformación para modificar los datos antes de importarlos. Por ejemplo, divida el nombre completo contenido en el archivo de origen en nombre y apellidos para que coincidan con las columnas de destino de una tabla.

Para implementar la asignación de transformación, use la tabla TransformationMapping y TransformationParameterMapping.

Los datos transformados deben ser compatibles con los tipos de columnas de Microsoft Dataverse.

La propiedad TransformationMapping.TransformationTypeName describen el tipo de transformación. Los valores válidos para esta propiedad se muestran en la tabla siguiente:

Columna	valor
`AddToCurrentDate`	`Microsoft.Crm.Transformations.AddToCurrentDate`
`AddToDate`	`Microsoft.Crm.Transformations.AddToDate`
`AdvancedAddToCurrentDate`	`Microsoft.Crm.Transformations.AdvancedAddToCurrentDate`
`AssignValue`	`Microsoft.Crm.Transformations.AssignValue`
`Concatenate`	`Microsoft.Crm.Transformations.Concatenate`
`Replace`	`Microsoft.Crm.Transformations.Replace`
`Split`	`Microsoft.Crm.Transformations.Split`
`Substring`	`Microsoft.Crm.Transformations.Substring`

En las siguientes secciones se describen las transformaciones disponibles.

Concatenación

Concatena cadenas y las separa con un delimitador.

Parámetros de entrada	Descripción
Prefijo	Cadena que se usa como prefijo en la cadena concatenada.
Sufijo	Cadena que se usa como sufijo en la cadena concatenada.
Delimitador	Un carácter o combinación de caracteres que separan las subcadenas dentro de la cadena concatenada. El delimitador no se usa entre el prefijo y la subcadena o entre el sufijo y la subcadena. No use los caracteres de retroceso (\b), nueva línea (\n) y retorno (\r) como delimitador.
<Variable>	Matriz de longitud variable que contiene subcadenas.

Parámetros de salida	Descripción
Cadena	Cadena concatenada.

División

Separa una cadena que incluye un delimitador en subcadenas. Puede haber un máximo de diez subcadenas.

Parámetros de entrada	Descripción
Cadena de entrada	Cadena que contiene una o varias subcadenas que se separan con delimitadores.
Delimitador	Un carácter o combinación de caracteres que separan las subcadenas dentro de la cadena. No use los caracteres de retroceso (\b), nueva línea (\n) y retorno (\r) o cadenas vacías como delimitador.

Parámetros de salida	Descripción
Variable	1 subcadena hasta un máximo de 10.

Por ejemplo, si la cadena de entrada contiene once subcadenas, el resultado contiene diez subcadenas tal como se muestra en el siguiente ejemplo:

Cadena de entrada: a;b;c;d;e;f;g;h;i;j;k

Salida:

 a  
 b  
 c  
 d  
 e  
 f 
 g
 h  
 i  
 j;k

Substring

Devuelve una subcadena de una longitud especificada, a partir de un punto especificado de la cadena.

Parámetros de entrada	Descripción
Cadena de entrada	Cadena que contiene una subcadena.
Índice inicial	Posición de inicio de la subcadena.
Duración	Longitud de la subcadena. Si la longitud es null, devuelve una cadena completa desde el índice de inicio.

Parámetros de salida	Descripción
Subcadena	Subcadena devuelta.

Reemplazar

Sustituye todos los casos de una cadena especificada por otra cadena especificada.

Parámetros de entrada	Descripción
Cadena de entrada	Cadena que contiene una cadena de búsqueda.
Cadena de búsqueda	Cadena de búsqueda. No use los caracteres de retroceso (\b), nueva línea (\n) y retorno (\r) como cadena de búsqueda.
Reemplazar cadena	Cadena que reemplaza. Use una cadena vacía para quitar una cadena de búsqueda. No use los caracteres de retroceso (\b), nueva línea (\n) y retorno (\r) como cadena que reemplaza.

Parámetros de salida	Descripción
Valor	Valor de reemplazo (igual que el valor asignado).

Asignar valor

Sustituye todos los valores por un valor especificado.

Parámetros de entrada	Descripción
Valor	Valor que desea asignar.

Parámetros de salida	Descripción
Valor	Valor de reemplazo (igual que el valor asignado).

Nota

Las transformaciones de fecha solo se pueden usar para fechas con formato correcto. Para obtener información sobre cómo dar formato a las fechas, vea la Ayuda de Dataverse.

Agregar a fecha

Agrega un número determinado de días, meses y años a una fecha.

Parámetros de entrada	Descripción
Fecha	Cadena de fecha que se va a modificar.
Desplazamiento de año	Valor positivo o negativo que se agrega al componente del año de una fecha de entrada.
Desplazamiento de mes	Valor positivo o negativo que se agrega al componente del mes de una fecha de entrada.
Desplazamiento de día	Valor positivo o negativo que se agrega al componente del día de una fecha de entrada.

Parámetros de salida	Descripción
Nueva fecha	Nueva cadena de datos que contiene el día, el mes y el año agregados en este orden.

Ajustar fecha actual y establecer hora

Agrega un número determinado de días, meses y años a la fecha actual y establece la hora especificada. Los desplazamientos solo pueden ser números enteros.

Parámetros de entrada	Descripción
Desplazamiento de año	Valor positivo o negativo que se agrega al componente del año de una fecha actual.
Desplazamiento de mes	Valor positivo o negativo que se agrega al componente del mes de una fecha actual.
Desplazamiento de día	Valor positivo o negativo que se agrega al componente del día de una fecha actual.
horas	Valor que se usa para establecer el componente de las horas de una fecha actual.
minutos	Valor que se usa para establecer el componente de los minutos de una fecha actual.
Segundos	Valor que se usa para establecer el componente de los segundos de una fecha actual.
Día de la semana	Día de la semana que puede ser lunes, martes, miércoles, jueves, viernes, sábado o domingo. Los días de la semana se representan en números enteros, empezando por el decimal 1 para lunes. Los valores por los días de la semana están incluidos en la enumeración `DayOfWeek`. Para obtener más información sobre esta enumeración, vea el tema de MSDN DayOfWeekEnumeration. Si la fecha actual calculada no está en el día especificado de la semana, se ajusta a la fecha anterior más próxima que esté en el día especificado de la semana. La fecha actual se ajusta siempre a una fecha anterior. Por ejemplo, si especifica miércoles como día de la semana y la fecha recién calculada es el martes 9 de marzo, entonces la fecha se ajusta al miércoles 3 de marzo.

Parámetros de salida	Descripción
Nueva fecha	Nueva cadena de datos que contiene el día, el mes y el año agregados en este orden.

Adición avanzada a fecha actual.

Agrega un número especificado de días, meses y años a la fecha actual. Se puede especificar si los desplazamientos son valores relativos a la fecha actual o absolutos. Los desplazamientos solo pueden ser números enteros.

Por ejemplo, si usa un valor absoluto de 3 para un desplazamiento de mes, el mes recién calculado es marzo. Si establece un desplazamiento relativo al mes de la fecha actual en 3 y el mes actual es abril, el mes recién calculado será julio.

Parámetros de entrada	Descripción
Desplazamiento de año	Valor positivo o negativo que se agrega al componente del año de una fecha actual o un año absoluto.
Modo de desplazamiento de año	Especifique si el desplazamiento es relativo a la fecha actual o al valor absoluto mediante la columna `TransformationParameterMapping.Data`. Si usa enlaces de tipo de compilación, puede usar la enumeración `TransformationOffsetMode` para especificar el desplazamiento absoluto o relativo. Para obtener una lista de valores de DataTypeCode, 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/entidad de Dataverse.
Desplazamiento de mes	Valor positivo o negativo que se agrega al componente del mes de una fecha actual o un mes absoluto.
Modo de desplazamiento de mes	Especifique si el desplazamiento es relativo a la fecha actual o al valor absoluto mediante la columna `TransformationParameterMapping.Data`. Si usa enlaces de tipo de compilación, puede usar la enumeración `TransformationOffsetMode` para especificar el desplazamiento absoluto o relativo. Para obtener una lista de valores de DataTypeCode, consulte los valores posibles para esta tabla.
Desplazamiento de día	Valor positivo o negativo que se agrega al componente del día de una fecha actual o un día absoluto.
Modo de desplazamiento de día	Especifique si el desplazamiento es relativo a la fecha actual o al valor absoluto mediante la columna `TransformationParameterMapping.Data`. Si usa enlaces de tipo de compilación, puede usar la enumeración `TransformationOffsetMode` para especificar el desplazamiento absoluto o relativo. Para obtener una lista de valores de DataTypeCode, consulte los valores posibles para esta tabla.
Horas	Valor que establece el componente de las horas de una fecha actual.
minutos	Valor que establece el componente de los minutos de una fecha actual.
Segundos	Valor que establece el componente de los segundos de una fecha actual.

Parámetros de salida	Descripción
Nueva fecha	Nueva cadena de datos que contiene el día, el mes y el año, agregados en este orden. Primero, se agregan los componentes relativos y después se usan los valores absolutos para formar una fecha.

Vea también

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