Microaplicaciones

Scripts de integración HTTP

Los scripts de integración HTTP le permiten automatizar mediante programación algunas de las funcionalidades de integración HTTP:

  • Carga de datos: Un script puede definir una o más funciones de sincronización que obtengan datos de un sistema de registro (SoR), los transformen y los guarden en caché.

  • Acciones de servicio: Un script puede definir una o más funciones que escriban datos en el SoR, obtengan información sobre un registro creado o actualizado y los guarden en caché.

  • Webhooks: Un script puede definir una o varias funciones que reaccionan a datos configurados y enviados por el sistema de registro de la aplicación.

Cada script define múltiples sincronizaciones y funciones de acción. La integración HTTP invoca a continuación estas funciones durante la ejecución de la sincronización o cuando el usuario de la microaplicación invoca una acción.

Se pueden encontrar recursos adicionales para desarrolladores relativos a la programación de microaplicaciones en Citrix Developer Portal.

Antes de comenzar

Para el uso de la funcionalidad de creación de scripts se asume que está familiarizado con el SoR de la aplicación de destino. Utilice el método de creación de scripts cuando se hayan agotado todos los demás métodos al configurar la integración.

A la hora de utilizar scripts para integraciones HTTP, debe seguir este proceso general:

  • Prepare el script que quiere importar a través de la interfaz de administración de microaplicaciones.
  • Los scripts deben escribirse en lenguaje JavaScript en el editor de texto o herramienta de desarrollo preferidos.
  • Cuando esté listo, importe el script a través de la ficha Integraciones de la interfaz de administración de microaplicaciones u, opcionalmente, introduzca el script directamente en el editor de texto proporcionado con la funcionalidad de programación.
  • Una vez importado, pruebe el script.

Importar un script

Puede importar el script preparado a través de la ficha Integraciones de la interfaz de administración de microaplicaciones. Siga estos pasos:

  1. Seleccione Scripting.

    Scripting

  2. Seleccione Cargar script. También puede introducir el script directamente en el área de texto seleccionando Modificar.

    Importar script

    Se abrirá una hoja.

  3. Arrastre el script a la ventana emergente de importación.
  4. El script se analiza y valida.

    Importación de script correcta

  5. Seleccione Importar.
  6. Se importa el script.

Nota:

Ahora puede modificar el script directamente en el editor de texto para scripts o actualizarlo importando de nuevo el archivo de script.

  • Puede ver la sincronización con scripts como dispositivos de punto final de datos en las pantallas Carga de datos, Acciones de servicio y Webhooks.
  • Puede ver la tabla definida por el script en la página de tablas.

    Tabla de scripts

  • Puede ver el resultado del script en el registro.
  • Puede ver las solicitudes realizadas por el script en el registro de sincronización.

Para ver y supervisar el script mientras se ejecuta, vaya a la pantalla de registros.

Preguntas frecuentes

Autenticación: La funcionalidad de creación de scripts utiliza el mismo cliente que el configurado para la integración del sistema de registro (SoR); por lo tanto, coincide con la autenticación definida en la integración HTTP.

Todos los parámetros configurados en Carga de datos y Acciones de servicio para el SoR de destino se propagan a los scripts.

Una vez cargados, los scripts se incluyen en la importación y exportación de microaplicaciones (por lo que se pueden importar o exportar al repositorio de paquetes).

Parámetros de integración personalizados

La funcionalidad de creación de scripts también admite parámetros de integración personalizados para la configuración de integraciones HTTP. Por ejemplo, la integración utiliza ID de aplicación específicos para hacer referencia a una aplicación específica en el espacio de trabajo de un usuario. Este ID es específico del usuario y deberá configurarse para cada integración.

Los parámetros personalizados o secretos se definen en la definición de Parámetro de configuración, que consta de:

  • nombre (cadena, sin espacios, sin caracteres especiales)
  • etiqueta (cadena)
  • descripción (cadena)
  • tipo (cadena, igual que el tipo de columna)
  • valor predeterminado (se rellena durante la importación)
  • obligatorio (booleano)
  • secreto (booleano) (los secretos nunca se registran en la caché o los registros de las microaplicaciones).

Otros recursos

Puede obtener información sobre cómo desarrollar scripts en Citrix Developer Portal.

Puede iniciarse en el desarrollo de scripts propios en Getting Started with Citrix Workspace Microapps Scripting.

Consulte ejemplos de scripts de microaplicaciones en SDK de scripts de microaplicaciones.

Obtenga la versión más reciente del SDK en Versiones del SDK de scripts de microaplicaciones.

Scripts de integración HTTP