Establecer valores en un OmniScript

Cambiar nombre de nodos JSON de datos

Simplifique y cambie el nombre de los nombres de nodos JSON accediendo a los valores en el JSON de datos de un OmniScript. Acceda a datos enviados al JSON de datos de OmniScript desde un parámetro, los datos de respuesta de una acción o un elemento utilizando campos de combinación.

1. Desde Diseñador de OmniScripts, haga clic en Vista previa.
2. Realice una vista previa del OmniScript y vea el JSON de datos resultante.
3. Localice el nodo JSON en el JSON de datos al que desea cambiar el nombre.
4. Agregue una acción Establecer valores al OmniScript.
5. En la acción Establecer valores, haga clic en Agregar valor de elemento.
6. En el Mapa de valores de elementos, en el campo Nombre de elemento, ingrese el nuevo nombre del nodo JSON.
7. En el Asignación de valor de elemento, en el campo Valor, ingrese el nombre del nodo JSON al que desea cambiar el nombre utilizando sintaxis de campo de combinación para asignarlo al nuevo nodo JSON.

   Este es un ejemplo del Mapa de valores de elementos de una acción Establecer valores que cambia el nombre de respuestas y parámetros:

   Nombre del elemento	Valor
   FirstName	%FirstNameHTTPResponse%
   LastName	%LastNameHTTPResponse%
   Antigüedad	%AgeParameter%

8. Realice una vista previa del OmniScript de nuevo y vea el nuevo nombre del nodo JSON.

Rellenar elementos de entrada con acción Establecer valores

Rellene elementos de entrada posteriores con valores procedentes de JSON de datos, operadores de fórmula, funciones, concatenaciones y valores estáticos. Rellene previamente un elemento directamente desde un Asignador de datos de OmniStudio o una respuesta de acción siempre que sea posible. Cuando un elemento anterior asigna un valor al Nombre de un elemento de entrada posterior, el elemento de entrada posterior se rellena con el valor asignado.

Por ejemplo, supongamos que una acción Establecer valores tiene un Mapa de valores que asigna un Nombre de elemento de FirstName con un Valor de John. Un elemento Texto posterior con un Nombre de FirstName se rellena con el valor John.

Nota

Al rellenar un elemento utilizando Establecer valores, los tipos de datos deben coincidir. Por ejemplo, no puede establecer un elemento Texto con un valor de un elemento Número.

1. En las propiedades Establecer valores, haga clic en Agregar valor de elemento.
2. En el Asignación de valor de elemento, en el campo Nombre de elemento, ingrese el nombre de un elemento de entrada en un elemento Paso posterior.
   

   Nota

   Cuando el Nombre del elemento se asigna a un elemento existente en OmniScript, el Tipo del elemento aparece entre los campos Nombre del elemento y Valor.

   Por ejemplo, el elemento Paso siguiente tiene elementos Texto FirstName y LastName, un elemento Número denominado Age y un elemento Fecha denominado Date.
3. En el Mapa de valores de elementos, en el campo Valor, ingrese un valor literal, una fórmula o el nombre de otro nodo JSON utilizando sintaxis de combinación.
   Ejemplos:

   Nombre del elemento	Valor
   FirstName	"John"
   LastName	%LastNameHTTPResponse%
   Antigüedad	%AgeParameter%
   Fecha	=TODAY()

4. Realice una vista previa de OmniScript para asegurarse de que los campos se rellenan correctamente.

Concatenar valores con valores establecidos

Cree valores dinámicos concatenando valores de nodos JSON.

Fórmulas y funciones con valores establecidos

Genere valores dinámicos evaluando datos con fórmulas y funciones para devolver valores específicos.

Después de agregar un valor de elemento en una acción de valores establecidos, defina el valor para un nodo JSON o nombre de elemento con una fórmula o función utilizando Utilizar expresión para valor. Agregue valores estáticos o valores dinámicos utilizando campos de combinación y agregue un operador.

Nota

Los operadores deben tener un espacio en cada lado para que la operación se ejecute correctamente.

Para asignar un valor nulo en JSON o comprobar valores nulos en un campo de datos, utilice $Vlocity.NULL. Utilice $Vlocity.NULL en estos escenarios:

Anular el establecimiento de un valor de campo

Para eliminar un valor en un campo definiéndolo como nulo. Utilice $Vlocity.NULL para asegurarse de que el sistema reconoce explícitamente el valor como nulo.

Comprobar condicionalmente nulo

Utilice $Vlocity.NULL en fórmulas para detectar cuándo un campo es nulo. Luego puede desencadenar ciertas acciones en consecuencia. Ejemplo: IF(%Step1:Multi-select1% == null, "$Vlocity.NULL", %Step1:Multi-select1%)

Establecer y acceder a datos anidados

Establezca y acceda a datos anidados modificando el JSON Establecer valores directamente y utilizando sintaxis específica.

"elementValueMap": {
          "ParentArray": {
          "NumberMap": [
          1000,
          2000,
          3000
          ]
          }
          },