Citizen Integrator Generar o Editar Receta¶

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 las integraciones de Design Studio utilizando recetas preconstruidas de Citizen Integrator.

Dentro de Citizen Integrator, puede cargar un Design Studio para generar una receta de Citizen Integrator y luego configure los pasos de la receta en la página Generar receta. Para recetas existentes, la página Editar receta también hace que esos pasos estén disponibles para editar.

Acceso a la Página de Generación de Recetas¶

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

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

Haga clic en el icono de JPK para abrir una ventana donde puede cargar un Design Studio Jitterpak que generará una receta.

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

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

Acceso a la Página de Edición de Recetas¶

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 puede actualizar los pasos de su receta (consulte Generación o edición de pasos de receta abajo).

Generación o Edición de 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: Proporcione o modifique el nombre de su receta.
• Descripción de la receta: Proporcione o modifique la descripción de su receta.

Variables del Proyecto de Receta¶

La siguiente sección se usa para agregar cualquier variable de proyecto a la receta para la que desea que los usuarios puedan establecer valores cuando usen la receta. Para obtener más información, consulte Variables.

Quitar o Restaurar Variables del Proyecto¶

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

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

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

Para restaurar una variable de proyecto que haya eliminado anteriormente, use el menú desplegable en la parte superior derecha para seleccionar una variable eliminada anteriormente y haga clic en el botón Restaurar variable.

Configurar Variables del Proyecto¶

En el lado derecho, los campos para la variable seleccionada están disponibles para ser configurados.

• Nombre: El nombre de la variable de su proyecto existente no se puede editar.

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

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

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

• Expresión Reg: Este campo se puede usar para proporcionar una expresión regular (cadena) que el valor de la variable del proyecto debe coincidir cuando se configura la receta antes de que se puedan usar las acciones Probar conexión o Ejecutar operación. Por ejemplo: ".+@.+[.].+".

• Tipo: Este campo se puede utilizar para definir el tipo de valor que el usuario puede proporcionar. Use el menú desplegable para seleccionar texto, contraseña, casilla de verificación, menú desplegable o área de texto. Para la casilla de verificación y el menú desplegable, las opciones adicionales están disponibles para configurar. Ingrese una Etiqueta y un Valor para cada selección o use el icono de la papelera para eliminar una fila.

  

• Campo obligatorio: Si se marca esta casilla, se requerirá que se complete el campo de la 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 los pasos de receta existentes.

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

Para eliminar un paso de la receta, haga clic en el icono de la papelera junto al nombre del paso a la izquierda. Los pasos 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 parte superior derecha. Se creará un nuevo paso antes del paso Revisar.

Configurar Pasos¶

En el lado derecho, los campos para el paso seleccionado están disponibles para ser configurados. Los siguientes campos son comunes para todos los tipos de pasos:

• Nombre del paso: Ingrese un nombre para que el paso aparezca 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 usa para ejecutar una operación antes de desplegar la receta.
  • API Binding: Se utiliza cuando existe la necesidad de externalizar operaciones como APIs.
• Descripción: Ingrese una descripción del paso que aparecerá dentro de la receta.

Cada tipo de paso y cualquier campo que esté disponible cuando se selecciona el paso se tratan en detalle a continuación.

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

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

  • Obligatorio: Marque esta casilla si desea solicitar que se complete este paso antes de desplegar la receta (por ejemplo, para probar o validar que la conexión de un extremo es 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 configuran en el apartado anterior.

  • Acción: Marque esta casilla si desea incluir una acción en el paso (p. ej., probar la conexión con las credenciales proporcionadas). Cuando está marcado, los siguientes campos adicionales están disponibles:

    • Nombre del botón: Ingrese un nombre para que aparezca en el botón de acción (p. ej., Probar conexión).
    • Paso Acción: Utilice el menú desplegable para seleccionar una acción. Todos los extremos existentes del archivo Jitterpak se enumerarán en el menú desplegable.

    Después de seleccionar una acción, se agregará automáticamente un paso de acción debajo del paso actual. Luego deberá hacer clic en el paso generado automáticamente en la lista de pasos a la izquierda para configurar los detalles del paso. Se proporciona más información en el tipo de paso generado automáticamente a continuación.

• Ejecutar operación: este tipo de paso se utiliza para ejecutar una operación desde el archivo Jitterpak.

  • Requerido: Marque esta casilla si desea solicitar que se complete este paso antes de desplegar la receta.
  • Ruta de operación: Aquí se enumerará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.
• API Binding: Este tipo de paso se utiliza cuando existe la necesidad de externalizar operaciones como APIs. Los campos deben contener la información necesaria para la API. Consulte API Manager para más información.

• Paso generado automáticamente: este tipo de paso se crea automáticamente cuando elige el tipo Configuración de paso y marca la casilla de verificación Acción con una Acción de paso seleccionada.

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

  • Conexiones de prueba: Todas las variables necesarias se muestran según la acción seleccionada. Puede codificar un valor predeterminado o usar 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 del proyecto que haya configurado en la sección anterior.

Configuración Posterior¶

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

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

  

• Guardar en archivo: Use 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). página).