Usted está aquí:
Asignar entradas y salidas para transformaciones
Para asignar datos desde la entrada a la salida, vaya a la ficha Transformación. Si está utilizando el diseñador en un paquete gestionado, vaya a la ficha Salida. También puede gestionar valores nulos, tipos de datos, almacenamiento en caché y transformaciones de lista.
Puede asignar datos utilizando uno de estos métodos:
-
Utilice Coincidencia rápida para asignar rápidamente datos de entrada y salida en una transformación de Asignador de datos. Consulte Utilizar coincidencia rápida para asignar datos.
-
Especifique cada asignación individualmente utilizando la opción Crear asignación.
Ambos métodos se aplican a entrada y salida de JSON y a otros tipos de entrada y salida.
Reestructuración y cambio de nombre de datos
Todos los tipos de Asignadores de datos pueden reestructurar datos y cambiar el nombre de campos utilizando asignaciones. Para reestructurar o cambiar el nombre de un campo, debe asignar la ruta de entrada a la ruta de salida que desee.
Este ejemplo muestra la entrada JSON asignándose a salida XML. Los campos de Caso de nivel superior entrantes, CaseNumber, AccountId y AccountName, se vuelven a relacionar bajo un elemento XML denominado <XCASEDETAILS>. Aunque la lista de contactos no cambia, tenga en cuenta la diferencia entre la representación de una lista en JSON y en XML. En JSON, la lista Contactos está entre corchetes, [], luego cada elemento de la lista Contactos está entre corchetes, {}. En XML, cada elemento de la lista Contactos está encerrado en un elemento <CONTACTOS>. Para obtener detalles acerca de la conversión entre JSON y XML, consulte XML y JSON en OmniStudio Data Mappers.
Para los tipos de salida PDF, Documento y Plantilla de documento, las asignaciones de salida se generan basándose en los campos en el archivo Salida de destino que seleccionó cuando creó la Transformación de asignador de datos.
De forma predeterminada, si un valor es nulo, no se crea ningún nodo para el campo en el JSON de salida. Para asegurarse de que se crea un nodo, independientemente de si el campo es nulo, vaya a la ficha Opciones y seleccione Incluir valores nulos en la respuesta.
Asignaciones de valor de entrada a valor de salida
Para verificar que sus asignaciones crean la estructura deseada, vaya a la ficha Vista previa, pegue la entrada de muestra en el panel Entrada en el lado izquierdo de la pantalla y haga clic en Ejecutar. Los resultados se muestran en el panel Respuesta.
Para verificar que sus asignaciones crean la estructura y el resultado deseados, vaya a la ficha Vista previa, pegue la entrada de muestra en el panel Entrada en el formato correcto y haga clic en Ejecutar. Los resultados aparecen en el panel Respuesta. La Transformación de asignador de datos genera el resultado deseado solo si el formato de datos de entrada es correcto. Por ejemplo, para el tipo de datos Fecha, debe introducir el formato compatible, que es mm/dd/aaaa o aaaa-mm-dd.
Para definir pares de valores clave para el resultado, abra la asignación, vaya a Transformar valores de mapa e introduzca valores en los campos de pares de valores clave. Por ejemplo, si el campo entrante contiene TRUE o FALSE y su OmniScript requiere un valor Y o N, introduzca TRUE o FALSE en el campo Clave e Y o N en el campo Valor, respectivamente.
Tipos de datos de salida
En la ficha Salida, puede especificar el tipo de datos de los datos de salida. Si cambia el tipo, asegúrese de elegir un tipo de salida compatible. (Por ejemplo, cambiar un tipo numérico a una cadena está bien, pero cambiar una cadena a un número es arriesgado, porque una cadena puede contener caracteres no numéricos.) Consulte Tipos de datos de salida del Asignador de datos de OmniStudio.
Almacenamiento en caché de datos
Puede configurar parámetros de almacenamiento en caché opcionales en la ficha Opciones:
Tiempo de vida en minutos: Si el almacenamiento en caché de datos está activado, determina cuánto tiempo permanecen los datos en el caché. El valor mínimo es 5.
Tipo de caché de Salesforce Platform: Activa el almacenamiento en caché de datos. Establecido en Caché de sesión para datos relacionados con usuarios y sus sesiones de inicio de sesión, o en Caché de organización para todos los demás tipos de datos. Consulte Mejora del rendimiento del asignador de datos con almacenamiento en caché.
Mantener el orden de lista al combinar múltiples entradas
Cuando asigna múltiples listas de entrada a la misma lista de salida en una transformación de Asignador de datos, el sistema no garantiza el orden de los elementos en la salida. Los resultados pueden variar entre ejecuciones.
Para garantizar un orden predecible y coherente, utilice una fórmula para combinar y filtrar las listas en vez de utilizar asignaciones directas.
Escenario de ejemplo
Tiene tres listas de entrada: inputList1, inputList2 y inputListNew. Desea combinarlos en una única OutputList donde los elementos de inputList1 siempre aparecen primero, seguidos de inputList2 y luego inputListNew.
Configuración requerida
- Eliminar asignaciones directas: Elimine cualquier asignación individual dirigida a la
OutputList. - Agregue una fórmula: En la ficha Fórmulas, cree una fórmula para combinar las listas en el orden que prefiera.
| Fórmula | Ruta de resultado de fórmula | Descripción |
|---|---|---|
LIST(inputList1, inputList2, inputListNew) |
Lista combinada | Combina las listas en el orden exacto especificado. |
FILTER(LIST(inputList1, inputList2, inputListNew), "PolicyNumber !=
null") |
Lista de salida | Combina las listas en orden y excluye elementos con Números de póliza nulos. |
Asignación del resultado
En la ficha Transformaciones, asigne el resultado de su fórmula a la ruta de salida final.
| Ruta JSON de entrada | Ruta JSON de salida |
|---|---|
| Lista de salida | Lista de salida |
- Utilizar coincidencia rápida para asignar datos
Partida rápida es una forma sencilla de asignar datos de entrada y salida en una transformación de Asignador de datos de OmniStudio. - Transformación de listas con asignadores de datos
Los asignadores de datos pueden realizar transformaciones de lista. Para asignar entrada a salida, los Asignadores de datos requieren una entrada de lista en la que cada valor esté emparejado con una clave.
