Recuperar datos con un procedimiento de integración en un OmniScript

Desde un OmniScript, llame a un Procedimiento de integración para recuperar datos de Salesforce y datos externos. Puede ejecutar múltiples acciones como un servicio desatendido (que carece de interfaz de usuario) a través de JavaScript o Apex Service.

Antes de empezar, cree un Procedimiento de integración para gestionar datos de OmniScript.

Nota Cuando agrega la misma acción Procedimiento de integración a dos o más OmniScripts que tienen una relación principal-secundario, establezca los valores en el OmniScript principal, incluso si el valor está pensado para su uso en el OmniScript secundario.

1. Después de agregar un elemento Procedimiento de integración, en las propiedades remotas, active la configuración Colocable en cola encadenable del Procedimiento de integración:

   Propiedad	Valor
   Método futuro Utilizar Future (en Designer para un paquete gestionado)	Especifica que el Procedimiento de integración se ejecuta de forma asíncrona, como un método futuro de Salesforce, que no puede devolver datos al OmniScript que llama.
   Encadenable	Activa la configuración Encadenable del Procedimiento de integración subordinado.
   Utilizar continuación	Activa un procedimiento de integración subordinado que llama a acciones de larga ejecución para utilizar continuaciones Apex.
   Colable	Activa pasos encadenables en el Procedimiento de integración subordinado para iniciar trabajos colocables en cola.
   Encadenable en cola	Activa la configuración Colocable en cola encadenable del procedimiento de integración.

2. En Opciones remotas, agregue este par clave-valor:

   Clave	Valor
   useQueueableApexRemoting	true

3. Utilice la propiedad Carga útil adicional para enviar pares clave-valor adicionales al Procedimiento de integración como datos de entrada.
4. Especifique cualquier propiedad de Acción de procedimiento de integración adicional que necesite.
5. Utilice las propiedades Transformaciones de envío/respuesta para especificar la entrada y para ajustar o cambiar el nombre del JSON de salida.

   • Send JSON Path: Especifica el nodo JSON que contiene la entrada para el procedimiento de integración. Este es normalmente el nombre de un elemento anterior en OmniScript.

   • Enviar nodo JSON: cambia el nombre del nodo JSON que contiene la entrada para el Procedimiento de integración. Este es normalmente el nombre de uno de los parámetros de entrada del Procedimiento de integración.

   • Ruta de JSON de respuesta: Especifica el nodo JSON que contiene la salida para volver al OmniScript. De forma predeterminada, se devuelven todos los datos de Procedimiento de integración.

   • Nodo JSON de respuesta: Cambia el nombre del nodo JSON que contiene la salida para volver al OmniScript. Este es normalmente el nombre de un elemento posterior en OmniScript.

   Consulte Manipular JSON con las propiedades Transformaciones de envío/respuesta.

6. Seleccione el comportamiento de respuesta de la acción seleccionando un Modo de invocación.

   • Predeterminado: Bloquea la interfaz de usuario con un centrifugador de carga.

   • No bloqueo: Se ejecuta de forma asíncrona y la respuesta se aplica a la interfaz de usuario. No se admiten las transformaciones del Asignador de datos previo y posterior a OmniEstudio ni los archivos adjuntos de gran tamaño. Cuando Modo de invocación está establecido como no bloqueo, los elementos que utilizan valores predeterminados no recibirán la respuesta porque el elemento se carga antes de que se devuelva la respuesta. Para asignar la respuesta a un elemento, debe establecer Nodo JSON de respuesta en VlocityNoRootNode y Ruta JSON de respuesta en el nombre del elemento.

   • Disparar y olvidar: Se ejecuta de forma asíncrona sin devolución de llamada a la interfaz de usuario. No se admiten las transformaciones del Asignador de datos previo y posterior ni los archivos adjuntos de gran tamaño. Una respuesta seguirá apareciendo en la consola de depuración pero no se aplicará al JSON de datos.

7. Cuando Modo de invocación está establecido como no bloqueo, los elementos que utilizan valores predeterminados no reciben la respuesta porque el elemento se carga antes de que se devuelva la respuesta. Debe configurar estas propiedades para asignar la respuesta a un elemento:

   Propiedad	Valor
   Nodo JSON de respuesta	VlocityNoRootNode
   Ruta JSON de respuesta	El nombre del elemento OmniScript que recibe el valor.

   Consulte Manipular JSON con las propiedades Transformaciones de envío/respuesta.

Nota Cuando un OmniScript invoca un Procedimiento de integración de forma asíncrona, el Procedimiento de integración continúa ejecutándose si el usuario pasa al siguiente paso, pero no si el usuario navega fuera del OmniScript.