Usted está aquí:
Utilizar fórmulas en Asignadores de datos de OmniStudio
Para agregar datos al resultado de un Asignador de datos, defina fórmulas. Varios tipos de Asignadores de datos (Extracción, Transformación y Carga) admiten fórmulas. Cuando define una fórmula, asigna su salida al JSON de salida (para extracciones y transformaciones) o al campo de objeto de Salesforce (para cargas).
Para obtener detalles acerca de los operadores y funciones que puede utilizar en fórmulas, consulte Fórmulas y funciones de OmniStudio.
Si un nombre de variable contiene espacios o caracteres no alfanuméricos, encierre el nombre de variable entre comillas dobles y precédalo con var: en fórmulas. Por ejemplo, si el nombre del nodo JSON es Primary Guardian, especifíquelo en fórmulas como var:"Primary Guardian".
Si el nombre de un campo personalizado incluye caracteres especiales, a veces no puede hacer referencia al campo en una fórmula.
En el tiempo de ejecución estándar de OmniStudio, introducir la fórmula de consulta incorrecta para Asignadores de datos devuelve nulo pero no muestra registros de errores. Si obtiene una respuesta nula de una consulta, actualice la consulta.
- En la página Interfaz de asignador de datos, vaya a la ficha Fórmulas.
- Haga clic en Agregar fórmula. Se agrega una fórmula vacía a la lista.
-
En el campo Fórmula, especifique la lógica que desee. Por ejemplo, para determinar el precio total de los artículos de compra por un cliente, introduzca una fórmula como:
SUM(Products:Price)También puede utilizar la notación de relaciones en fórmulas para hacer referencia a campos en un objeto principal. Consulte Anotación de relación frente a múltiples pasos de extracción.
- En el campo Ruta de resultado de fórmula, especifique un nodo JSON en el que almacenar el resultado de fórmula.
-
Asigne el resultado al resultado final.
- Para un Asignador de datos de extracción, en la ficha Salida, asigne el resultado de fórmula a la estructura de salida. Utilice un punto y coma (:) para delimitar niveles en las rutas de entrada y salida en asignaciones.
- Para un Asignador de datos de transformación, en la ficha Transformaciones, asigne el resultado de fórmula a la estructura de salida. Utilice un punto y coma (:) para delimitar niveles en las rutas de entrada y salida en asignaciones.
- Para un Asignador de datos de carga, para cada sObject que desee actualizar, en la ficha Campos, asigne el resultado de fórmula al campo que desea actualizar.
- Cargar: Para cada sObject que desee actualizar, vaya a su ficha Campos y asigne el resultado de fórmula al campo específico que desea actualizar.
Crear un ejemplo de Asignador de datos de OmniStudio con una fórmula
El siguiente ejemplo acepta una lista de precios y utiliza una fórmula para calcular el precio total.
Para crear esta transformación de Asignador de datos, realice estos pasos:
- Vaya a la ficha Diseñador de Asignador de datos de OmniStudio y haga clic en Nuevo. Se muestra el cuadro de diálogo Crear.
-
Especifique un nombre para el Asignador de datos y configure sus parámetros del siguiente modo:
- Tipo de interfaz: Transformación
- Tipo de entrada: JSON
- Tipo de salida: JSON
- Haga clic en Guardar. Se muestra la página Interfaz de asignador de datos.
- Vaya a la ficha Fórmulas y haga clic en Agregar fórmula.
- En el campo Fórmula, introduzca SUM(Products:Price).
- En el campo Ruta de resultado de fórmula, introduzca TotalPrice.
-
En la ficha Transformaciones, amplíe el panel JSON de entrada y pegue esta estructura JSON en él:
{ "CustomerName": "Bob Smith", "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } -
Amplíe el panel Salida JSON esperada y pegue esta estructura JSON en él:
{ "CustomerName": "Bob Smith", "TotalPrice": 830, "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } - Haga clic en Partida rápida. En la ventana Partida rápida, haga clic en Partida automática y, a continuación, haga clic en Guardar.
-
En la ficha Vista previa, haga clic en Ejecutar.
Si creó el ejemplo correctamente, la estructura de JSON en el panel Respuesta coincide con la Salida de JSON esperada excepto por el orden de los nodos de nivel superior.
-
En el panel Entrada, cambie uno o más de los precios y, a continuación, haga clic en Ejecutar de nuevo.
Observe cómo cambia el valor de
TotalPrice.
