Generar recetas y editar páginas de recetas en Jitterbit Citizen Integrator

Introducción

Citizen Integrator, accesible a través del portal Harmony, es la aplicación web de hacer clic y ejecutar de Jitterbit para que los usuarios no técnicos personalicen e desplegar rápidamente integraciones de Design Studio utilizando recetas de Citizen Integrator prediseñadas.

Dentro de Citizen Integrator, puedes cargar un Design Studio proyecto para generar una receta de Citizen Integrator y luego configurar los pasos de la receta en la página Generar Receta. Para las recetas existentes, la página Editar Receta también permite editar esos pasos.

Nota

Las recetas de Citizen Integrator se pueden generar desde Design Studio o importar a este) solamente. Para Integration Studio, en su lugar utilice Recetas de integración de Integration Studio o Plantillas de proceso de Integration Studio, al que se accede a través de Jitterbit Marketplace.

Advertencia

Solo los usuarios que sean miembros de un rol con permiso Admin dentro de la organización seleccionada pueden generar y editar recetas de Citizen Integrator dentro de la organización.

Acceda a la página de generación de receta

La opción para generar una receta de Citizen Integrator está disponible en Citizen Integrator - Mis recetas. Después de generar la receta, accederás a la página Generar receta para configurar los pasos de la receta.

Desde la página Mis recetas, en la sección Mis recetas, la opción de generar una receta está disponible solo para usuarios con permisos de administrador dentro de la organización seleccionada.

Haga clic en el ícono JPK para abrir una ventana donde podrás cargar un Design Studio Jitterpak que generará una receta.

En la ventana Generar receta, utilice el botón Elegir archivo para buscar el Jitterpak (.JPK) que desea cargar.

Luego haga clic en Enviar para generar su nueva receta y abrir la página Generar receta donde puede configurar aún más los pasos de su receta (consulte Generar o editar los pasos de la receta abajo).

Acceda a la página de edición de receta

La opción para editar una receta de Citizen Integrator está disponible en Citizen Integrator - Mis recetas página.

Desde la página Mis recetas, en la sección Mis recetas, la opción para editar una receta estará disponible una vez que haya seleccionado solo una receta dentro de la tabla, y estará disponible solo para usuarios con permisos de administrador dentro de la organización seleccionada.

Para seleccionar una receta, haga clic en cualquier lugar de la fila o marque la casilla a la izquierda de la receta.

Luego haga clic en el icono de edición para abrir la página Editar receta donde puedes actualizar los pasos de tu receta (consulta Generar o editar los pasos de la receta abajo).

Generar o editar pasos de receta

Una vez que haya accedido a las páginas Generar receta o Editar receta como se describe anteriormente, puede configurar los pasos de la receta a través de la interfaz de usuario de Citizen Integrator de la siguiente manera.

Nombre y descripción de la receta

En la primera sección, ingrese el nombre básico y la descripción de su receta.

• Nombre de la receta: Proporciona o modifica el nombre de tu receta.
• Descripción de la receta: Proporciona o modifica la descripción de tu receta.

Variables del proyecto de recetas

La siguiente sección se utiliza para agregar a la receta las variables de proyecto que desee que los usuarios puedan configurar al receta. Para más información, consulte Variables.

Eliminar o restaurar variables del proyecto

En el lado izquierdo, se enumerarán todas las variables del proyecto existentes.

• Generar receta: Al generar una receta, se muestran todas las variables del proyecto del archivo Jitterpak. Si no se incluyen variables del proyecto en el archivo Jitterpak, no se mostrará ninguna.
• Editar receta: Al editar una receta, se muestran las variables del proyecto existentes de los metadatos JSON de la receta o de la receta generada previamente.

Para eliminar una variable de proyecto de la receta, haga clic en el ícono de la papelera junto al nombre de la variable del proyecto, a la izquierda.

Para restaurar una variable del proyecto que haya eliminado previamente, utilice el menú desplegable de la esquina superior derecha para seleccionarla y haga clic en el botón Restaurar variable.

Consejo

No se pueden agregar nuevas variables de proyecto que no existan en Jitterpak para la receta. Si desea agregar una nueva variable de proyecto, primero debe crearla en Jitterpak en Design Studio.

Configurar variables del proyecto

En el lado derecho están disponibles para configurar los campos de la variable seleccionada.

• Nombre: El nombre de la variable de su proyecto existente no es editable.

• Nombre para mostrar: Este campo se puede utilizar si desea que se muestre un nombre diferente en la interfaz de Citizen Integrator.

• Descripción: Este campo se puede utilizar para insertar texto debajo del campo, por ejemplo, para proporcionar instrucciones sobre lo que los usuarios deben ingresar.

• Valor: Este campo se puede usar si desea asignar un valor predeterminado a la variable de su proyecto. Permite proporcionar un valor predeterminado con otros valores opcionales. Por ejemplo, un valor predeterminado de "Producción" con otras opciones para "Desarrollo" o "Control de calidad". Estas opciones se encuentran en el campo Tipo.

• Expresión regular: Este campo permite proporcionar una expresión regular (cadena) con la que debe coincidir el valor de la variable del proyecto al configurar la receta antes de poder usar las acciones Probar conexión o Ejecutar operación. Por ejemplo: ".+@.+[.].+".

• Tipo: Este campo permite definir el tipo de valor que el usuario puede proporcionar. Utilice el menú desplegable para seleccionar entre texto, contraseña, casilla de verificación, menú desplegable o área de texto. Para las casillas de verificación y los menús desplegables, se ofrecen opciones adicionales para configurar. Introduzca una Etiqueta y un Valor para cada selección o utilice el icono de la papelera para eliminar una fila.

  

• Campo obligatorio: Si esta casilla está marcada, será necesario completar el campo de variable del proyecto cuando se configure la receta antes de que se puedan usar las acciones Probar conexión o Ejecutar operación.

Pasos de la receta

La siguiente sección se utiliza para configurar los pasos que los usuarios deberán seguir para configurar la receta de Citizen Integrator.

Agregar o quitar pasos

En el lado izquierdo, se enumerarán todos los pasos de la receta existente.

• Generar receta: Al generar una receta, se agregan de forma predeterminada los pasos de Introducción y Revisión.
• Editar receta: Al editar una receta, se muestran los pasos existentes de los metadatos JSON de la receta o de la receta generada previamente.

Para eliminar un paso de la receta, haga clic en el ícono de la papelera junto al nombre del paso a la izquierda. Los pasos de Introducción y Revisión, así como los pasos generados automáticamente, no se pueden eliminar.

Para agregar un nuevo paso, haga clic en el botón Agregar nuevo paso en la esquina superior derecha. Se creará un nuevo paso antes del paso de Revisión.

Configurar pasos

En el lado derecho, se pueden configurar los campos del paso seleccionado. Los siguientes campos son comunes para todos los tipos de paso:

• Nombre del paso: Ingrese un nombre para el paso que aparecerá dentro de la receta (por ejemplo, Introducción o Autenticación de Salesforce).
• Tipo: Seleccione uno de los siguientes tipos de pasos:
  • Descripción: Se utiliza para proporcionar información sobre la receta y/o sus componentes.
  • Configuración de pasos: Se utiliza para definir una o más variables del proyecto para verificar la conectividad de un extremo específico.
  • Ejecutar operación: Se utiliza para ejecutar una operación antes de que se implemente la receta.
  • Enlace de API: Se utiliza cuando es necesario externalizar operaciones como APIs.
• Descripción: Ingrese una descripción del paso que aparecerá dentro de la receta.

A continuación se describen en detalle cada tipo de paso y los campos que aparecen disponibles cuando se selecciona el paso.

Nota

Se proporciona información adicional y documentación sobre todas las partes posibles del archivo de metadatos JSON en Creación de nuevas recetas.

• Descripción: Este tipo de paso se utiliza para proporcionar información sobre la receta y/o sus componentes.
  • Detalles: Ingrese aquí cualquier HTML que desea que se represente en este paso.

• Configuración de paso: Este tipo de paso generalmente se utiliza para probar una conexión de extremo.

  • Obligatorio: Marque esta casilla si desea exigir que este paso se complete antes de desplegar la receta (por ejemplo, para probar o validar que una conexión de extremo sea exitosa).
  • Variables del proyecto: Use el menú desplegable para agregar variables del proyecto al paso o use el icono de la papelera para eliminarlas. Las variables del proyecto se configuraron en la sección anterior.

  • Acción: Marque esta casilla si desea incluir una acción en el paso (por ejemplo, probar la conexión con las credenciales proporcionadas). Al marcarla, se habilitarán los siguientes campos adicionales:

    • Nombre del botón: Ingrese un nombre para que aparezca en el botón de acción (por ejemplo, Probar conexión).
    • Acción de paso: Use el menú desplegable para seleccionar una acción. Todos los extremos existentes del archivo Jitterpak aparecerán en el menú desplegable.

    Tras seleccionar una acción, se añadirá automáticamente un paso de acción debajo del paso actual. A continuación, deberá hacer clic en el paso generado automáticamente en la lista de pasos de la izquierda para configurar los detalles del paso. Encontrará más información en el tipo de paso generado automáticamente a continuación.

• Operación de ejecución: Este tipo de paso se utiliza para ejecutar una operación desde el archivo Jitterpak.

  • Obligatorio: Marque esta casilla si desea exigir que este paso se complete antes de desplegar la receta.
  • Ruta de la operación: Aquí se listarán todas las operaciones existentes del archivo Jitterpak. Seleccione la operación que desea ejecutar en esta parada.
  • Descripción de la operación: Ingrese una descripción sobre la operación seleccionada para proporcionar información en la receta sobre lo que hace la operación.
• Enlace de API: Este tipo de paso se utiliza cuando es necesario externalizar operaciones como APIs. Los campos deben contener la información necesaria para la API. Consulte API Manager para más información.

• Paso Autogenerado: Este tipo de paso se crea automáticamente al seleccionar el tipo Configuración de Paso y marcar la casilla Acción con una Acción de Paso seleccionada.

  • Ejecutar Operación: Consulte el paso "Ejecutar Operación" anterior para obtener información sobre los campos configurables.

  • Probar Conexiones: Se muestran todas las variables necesarias según la acción seleccionada. Puede codificar un valor predeterminado o usar las variables de proyecto configuradas en la sección anterior.

    

    • Valor predeterminado: Escriba un valor predeterminado en el cuadro de texto para codificar el valor de la variable. Los usuarios no podrán cambiar este valor al desplegar una receta.
    • Variable del proyecto: Marque la casilla de verificación y use el menú desplegable para seleccionar una variable de proyecto que haya configurado en la sección anterior para usar.

Postconfiguración

Una vez que haya configurado su receta de Citizen Integrator generada o editada como se describe anteriormente, utilice los botones en la parte inferior de la página cuando esté listo.

• Vista previa: Utilice este botón para ver una vista previa del archivo JSON generado que se utilizará para su receta.

  

• Guardar en archivo: Utilice este botón para descargar el archivo JSON generado.

• Cancelar: Utilice este botón para cerrar la página sin guardar los cambios.

• Cargar / Actualizar: Estos botones validarán la receta y la cargarán en la organización seleccionada (en la página Generar receta) o actualizarán la receta (en la página Editar receta).