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 componente en Lienzo de diseño).
-
La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componente 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 Variable Escritura. El nombre debe ser único para cada actividad de Variable Escritura 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 Variable Escritura. 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 Terminado 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 detalles sobre la configuración de cualquier variable requerida utilizada por el plugin, consulta Plugins añadidos a una actividad.
-
Regresar: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Terminado: Haga 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, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Próximos pasos
Después de configurar una actividad de Variable Escribir, se puede utilizar 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, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También se pueden configurar los ajustes de operación de una operación, que incluyen 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. Consulte el menú de acciones de actividad para más detalles.
Las actividades de Variable Escribir se pueden utilizar 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 (solo como el segundo objetivo)
- Patrón de archivo HTTP de dos objetivos (solo como el segundo objetivo)
- Patrón de dos transformaciones (solo como el segundo objetivo)
- Patrón de origen masivo de Salesforce
Otros patrones no son válidos utilizando actividades de Escritura de Variable. Consulte los patrones de validación en la página de validez de operación.
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, implemente y ejecute la operación y valide el comportamiento revisando los registros de operación.
Importante
De forma predeterminada, las operaciones exitosas configuradas para una API personalizada no se incluyen en los registros de operación 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 operación en la operación.
- Agentes privados: Para operaciones de API en un agente privado, se debe habilitar el registro de depuración de operación en la operación o debe establecer
EnableLogging=trueen la sección[APIoperation]del archivo de configuración del agente privado.