Actividad de Escritura de Variable
Introducción
Una actividad de Escritura de Variable, utilizando su conexión de variable, escribe datos en una variable y está destinada a ser utilizada como un objetivo para consumir datos en una operación o para ser llamada en un script.
Para obtener más información sobre el uso de variables en scripts, transformaciones y pantallas de configuración de conexión/actividad, consulte Variables.
Crear una actividad de Escritura de Variable
Una instancia de una actividad de Escritura de Variable se crea a partir de una conexión de variable utilizando su tipo de actividad Escritura.
Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.
Una actividad de Escritura de Variable existente se puede editar desde estas ubicaciones:
-
El lienzo de diseño (consulte Menú de acciones de componentes en Lienzo de diseño).
-
La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
Configurar una actividad de Escritura de Variable
Siga estos pasos para configurar una actividad de Escritura de Variable:
Paso 1: Ingrese un nombre y proporcione un esquema de solicitud
-
Nombre: Ingresa un nombre para identificar la actividad de Escritura de Variable. El nombre debe ser único para cada actividad de Escritura de Variable y no debe contener barras diagonales (
/
) ni dos puntos (:
). -
Proporcionar esquema de solicitud: El esquema de solicitud define la estructura de los datos que utiliza la actividad de Escritura de Variable. Si se requiere un esquema de solicitud depende de si la actividad se utiliza como el objetivo de una transformación (ver Uso de esquemas). Para instrucciones sobre cómo completar esta sección de la configuración de la actividad, consulta Esquemas definidos en una actividad.
-
Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.
-
Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.
-
Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pedirá que confirmes que deseas descartar los cambios.
Paso 2: Revisar los esquemas de datos
-
Esquema de datos: Si se proporciona durante la configuración de la actividad, se muestra el esquema de datos de solicitud. Si la operación utiliza una transformación, los esquemas de datos se mostrarán nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puedes definir esquemas directamente en una transformación.
-
Agregar plugin(s): Los plugins son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un plugin a la actividad, haz clic para expandir esta sección y selecciona la casilla junto al plugin que se utilizará. Para instrucciones adicionales sobre el uso de plugins, incluidos los detalles sobre la configuración de cualquier variable requerida por el plugin, consulta Plugins añadidos a una actividad.
-
Regresar: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.
-
Finalizado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.
Siguientes pasos
Después de configurar una actividad de Variable Escribir, puedes usarla dentro de una operación o script como se describe a continuación.
Completar la operación
Después de configurar una actividad de Variable Escribir, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar la configuración de operación de una operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.
Una vez que se ha creado una actividad de Variable Escribir, las acciones del menú para esa actividad son accesibles desde el panel del proyecto en las pestañas de Flujos de trabajo o Componentes, y desde el lienzo de diseño. Consulta Menú de acciones de actividad para más detalles.
Las actividades de Variable Escribir pueden usarse como un objetivo con estos patrones de operación:
- Patrón de archivo
- Patrón de script
- Patrón de transformación
- Patrón de archivo de dos objetivos (como el segundo objetivo únicamente)
- Patrón de archivo HTTP de dos objetivos (como el segundo objetivo únicamente)
- Patrón de dos transformaciones (como el segundo objetivo únicamente)
- Patrón de origen masivo de Salesforce
Otros patrones no son válidos al usar actividades de Escritura de Variable. Consulte los patrones de validación en la página de validez de operaciones.
Para usar la actividad con funciones de scripting, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de scripting.
Cuando esté listo, despliegue y ejecute la operación y valide el comportamiento revisando los registros de operaciones.
Importante
De forma predeterminada, las operaciones exitosas configuradas para una API personalizada no se incluyen en los registros de operaciones a menos que se habilite una de estas configuraciones:
- Agentes en la nube: Para operaciones de API en un agente en la nube, se debe habilitar el registro de depuración de operaciones en la operación.
- Agentes privados: Para operaciones de API en un agente privado, se debe habilitar el registro de depuración de operaciones en la operación o debe establecer
EnableLogging=true
en la sección[APIoperation]
del archivo de configuración del agente privado.