Crear complementos de App Builder usando C# en Jitterbit App Builder

Los complementos son extensiones que amplían la funcionalidad de App Builder. Una serie de complementos se envían con App Builder y están disponibles para su uso inmediato. Sin embargo, los desarrolladores también pueden crear sus propios scripts para aumentar el rango de utilidades posibles. Esta página describe cómo hacerlo.

Detalles del script personalizado

Los scripts personalizados en C# se compilan con el compilador .NET Roslyn. Cada tipo de script define un conjunto de miembros globales que proporcionan acceso a objetos y servicios.

Cada script en C# tiene un propósito, que determina cómo y dónde se puede usar el complemento. Un complemento también puede generar un archivo de informe. Se selecciona un propósito para su complemento personalizado al crearlo. Los propósitos que puede servir un script en C# se enumeran en la sección Cómo crear un complemento en C#.

Ensamblados

Los complementos de App Builder pueden hacer referencia a código externo mediante el uso de ensamblados. Un ensamblado es un archivo (que generalmente termina en .dll) que contiene una biblioteca de código preescrito que su script puede utilizar para realizar tareas específicas, por ejemplo, matemáticas complejas o buscar la dirección IP de un sitio web.

A partir de App Builder 4.57, es posible cargar un archivo de biblioteca (archivo ZIP) que contenga las versiones específicas de los ensamblados que su script necesita. Esto asegura que su script permanezca aislado y estable, incluso cuando el resto del sistema se actualiza.

Después de cargar su ensamblado en App Builder, indique a sus scripts que lo utilicen agregando una directiva de referencia en la parte superior de su código (consulte la sección Cómo crear un complemento en C#).

Cómo crear un complemento en C# en App Builder

Para crear un complemento en C# en App Builder, siga estos pasos:

1. En el servidor donde desea usar su script, navegue a IDE > Configuración adicional.

2. Haga clic en Complementos.

3. El panel de Ensamblados lista los ensamblados existentes. Si el ensamblado que necesita ya existe, selecciónelo y pase al Paso 4. Si no, siga estos pasos para crearlo:

   1. Haz clic en + Assembly. Se abre un diálogo:

      

   2. Configura los siguientes campos:

      • Nombre: Ingresa un nombre para el nuevo ensamblaje.

      • Descripción: (Opcional) Ingresa una breve descripción del ensamblaje para ayudar a otros desarrolladores.

      • Tipo: Selecciona una de las opciones:

        • Compilado: Los plugins se compilan como parte de un ensamblaje .NET.

        • Scripts: Los plugins son guionizados.

      • ID de ensamblaje: Identificador único del ensamblaje. Este campo es generado automáticamente por App Builder.

      • Bibliotecas: Localiza y sube el archivo ZIP que contiene cualquier ensamblaje o recurso requerido por los scripts en este ensamblaje. El archivo se extraerá en el disco antes de que se ejecuten los plugins. Cualquier ensamblaje se registrará automáticamente y estará disponible para los scripts.

4. El panel de Plugins lista los plugins existentes. Haz clic en + Plugin para agregar uno nuevo. Se abre un diálogo:

   

5. Configura los siguientes campos:

   • Nombre: Ingresa un nombre para tu plugin.

   • Descripción: (Opcional) Ingresa una breve descripción del plugin para ayudar a otros desarrolladores.

   • Propósito: Selecciona uno de los propósitos:

     • Predeterminado

     • Solicitud de Endpoint

     • Respuesta de Endpoint

     • Informe

     • Solicitud Rest

     • Respuesta Rest

     • Acción de Fila

     • Acción de Tabla

     • Predeterminado de UI

     • Validación

     • Visibilidad

   • ID del plugin: Identificador único del plugin. Este campo es generado automáticamente por App Builder.

6. Haz clic en Guardar. App Builder creará el plugin y el panel de Script se convertirá en un campo editable donde puedes ingresar tu código en C#.

   Si deseas usar una biblioteca externa en tu script, aquí es donde la referenciarías utilizando la directiva #r (que significa "referencia") en la parte superior de tu código. Por ejemplo:

   #r "AssemblyName"