Conector App Builder en Jitterbit App Builder

Descripción general

El conector App Builder es una función que permite que una aplicación use tablas y objetos comerciales de otra aplicación App Builder, o de un entorno App Builder completamente diferente, como si fueran parte de su propia fuente de datos, sin duplicar los datos subyacentes.

El tipo de variante que uses depende de dónde se encuentre la otra aplicación:

• Un conector local vincula dos fuentes de datos en el mismo servidor App Builder. Por ejemplo, si tu servidor aloja tanto una fuente de datos Northwinds como una My Application independiente, y My Application necesita leer (y opcionalmente escribir) datos de Northwinds, un conector local le da a My Application acceso directo a las tablas de Northwinds, sin copiar esos datos en la base de datos propia de My Application. Debido a que ambas aplicaciones se ejecutan en el mismo servidor, App Builder maneja la conexión internamente: no se requiere una llamada de red ni un paso de autenticación independiente.

• Un conector remoto vincula dos entornos App Builder completamente independientes, cada uno con su propia URL, a través de HTTP. Por ejemplo, conectar el servidor App Builder de tu organización a una instalación App Builder diferente, ya sea un entorno independiente, la instalación de un cliente diferente, o cualquier otra instancia alojada de forma independiente. Debido a que la conexión atraviesa la red hacia una instancia App Builder asegurada por separado, se autentica usando una clave API, de la misma manera que lo haría cualquier otro cliente REST externo.

Esta página cubre:

• Conector local App Builder
  Configura un conector entre dos fuentes de datos en el mismo entorno.

• Conector remoto
  Configura un conector entre dos entornos App Builder independientes a través de HTTP.

Además, esta página también contiene una sección Limitaciones que cubre restricciones conocidas a tener en cuenta antes de depender del conector App Builder, y una sección Solución de problemas que cubre errores comunes y cómo resolverlos.

Conector local App Builder

Un conector local App Builder permite que una aplicación en tu servidor App Builder use directamente tablas y objetos comerciales que residen en la fuente de datos de otra aplicación en ese mismo servidor, sin copiar los datos ni configurar ninguna autenticación de red. Por ejemplo, si My Application necesita leer datos que residen en la fuente de datos Northwinds, ambas alojadas en el mismo servidor, un conector local le da a My Application acceso directo a las tablas públicas de Northwinds.

Esta sección cubre:

• Paso 1: Crear un conector local App Builder
• Paso 2: Permitir acceso público a las tablas y objetos comerciales que deseas usar en tu conector
• Paso 3: Crear una fuente de datos usando el conector local App Builder
• Paso 4: Importar tablas y objetos comerciales en tu conector
• Paso 5: Agregar tu conector local App Builder como fuente de datos a tu aplicación
• Paso 6: Vincular tu fuente de datos del conector local App Builder y tu base de datos relacional

Paso 1: Crear un conector local App Builder

Configura el servidor del conector App Builder, para que App Builder sepa que debe enrutar las solicitudes de esta conexión localmente en lugar de a través de HTTP:

1. Selecciona IDE > Data Servers.

2. Haz clic en + Server desde el panel Data Servers. Se abre el diálogo Server. Ingresa los siguientes valores:

   

   • Name: Asigna un nombre a tu conexión de servidor. Jitterbit recomienda Local App Builder.
   • Type: Selecciona App Builder Connector.
   • App Builder Type: Selecciona Local.

3. Haz clic en Save y cierra el diálogo.

Step 2: Permite el acceso público a las tablas y objetos de negocio que deseas usar en tu conector

Antes de que un conector pueda usar una tabla o regla, debe marcarse como Public:

1. Ve al App Workbench de la aplicación que deseas usar.

2. Marca las tablas o reglas que quieres usar en tu conector como Public:

   • Para marcar una tabla como pública:

     1. Ve a la pestaña Tables.
     2. Ubica la tabla que buscas en el panel Tables y haz clic en su ícono de edición o haz doble clic en su fila. Se abre la página Table Definition para esa tabla.

     3. En el panel Table, haz clic en More > Edge Case. Se abre el diálogo Edge Case Settings:

        

     4. En el grupo de campos Public Access, marca Allow Read y/o Allow Write según sea necesario.

   • Para marcar una regla como pública:

     1. Ve a la pestaña Rules.
     2. Ubica la regla que buscas en el panel Rules y haz clic en su ícono de edición o haz doble clic en su fila. Se abre el Rule Builder para esa regla.

     3. En el panel Rule, haz clic en More > Edge Case. Se abre el diálogo Edge Case Settings:

        

     4. En el grupo de campos Allow Public Access, marca Read para permitir la lectura de los datos de la regla, y/o Write para permitir su modificación.

Step 3: Crea una fuente de datos usando el conector local de App Builder

Con el servidor conector en su lugar y tus objetos marcados como públicos, crea una fuente de datos que apunte a la aplicación específica cuya información deseas usar:

1. Ve a IDE > Data Servers.
2. En el panel Data Servers, selecciona Local App Builder.

3. Haz clic en + Source. Aparece un asistente para guiarte a través del proceso:

   

4. Selecciona una base de datos en la que crear una fuente de datos. La fuente de datos se crea con el mismo nombre que la base de datos. Haz clic en Next.

   Nota

   La base de datos relacional que buscas debe tener al menos una tabla o regla pública (consulta Step 2); de lo contrario, no es seleccionable.

5. En el siguiente paso del asistente, elige qué tablas, vistas y procedimientos almacenados deseas importar en la fuente recién creada, o haz clic en Import All para importar todo. Haz clic en Next.

6. El asistente presenta un resumen de la nueva fuente de datos. Haz clic en Done. La nueva fuente de datos ahora aparece listada bajo + Source.

7. (Recomendado) Es una práctica recomendada cambiar el nombre de la fuente de datos siguiendo la convención [Data Source You're Connecting to] ([Application Using the Connector]). Por ejemplo, un conector local para Northwinds, conectando a una aplicación denominada My Application, se llamaría Northwinds (My Application). Para cambiar el nombre de tu fuente de datos, sigue estos pasos:

8. Haz clic en el icono de ventana nueva en el mosaico de la fuente de datos o haz doble clic en el mosaico mismo. Se abre el diálogo App Builder Connector:

   ![Diálogo App Builder Connector](/_download/images/app-builder/connect/app-builder-connector-dialog.png){style="width: 600px"}
   

   1. Haz clic en Edit. Se abre el diálogo Data Storage Layer:

      

   2. Haz clic en Edit nuevamente. Ingresa un nombre apropiado en el campo Data Source Name.

   3. Haz clic en Save.

Paso 4: Importar tablas y objetos de negocio en tu conector

Si seguiste los pasos anteriores en orden, las tablas públicas y las reglas se importaron cuando creaste la fuente de datos. Continúa en el Paso 5. Sin embargo, si creaste la fuente de datos antes de permitir acceso público a las tablas y reglas que necesitas, puedes importarlas ahora.

1. Ve a IDE > Data Servers.
2. En el panel Data Servers, selecciona Local App Builder.

3. En el panel lateral, haz clic en el icono de ventana nueva en el mosaico de la fuente de datos o haz doble clic en el mosaico mismo. Se abre el diálogo App Builder Connector:

   

4. En Data Storage Layer, haz clic en Import. Se abre el diálogo Import Schema:

   

   • Para importar cada tabla que marcaste como pública, haz clic en Import nuevamente desde Import Capabilities.

   • Para importar solo un subconjunto, ingresa primero un nombre de tabla u objeto de negocio en el campo Import Pattern, luego haz clic en Import desde Import Capabilities.

5. Haz clic en Proceed. App Builder ejecuta una tarea de fondo para completar la importación.

Paso 5: Agregar tu conector local de App Builder como fuente de datos a tu aplicación

La fuente de datos que creaste en el Paso 3 existe en el servidor, pero tu aplicación no puede usarla hasta que la agregues explícitamente como fuente:

1. Navega a App Workbench de la aplicación que desees modificar.
2. Ve a la pestaña Data Sources.
3. En el panel Data Sources, haz clic en + Source. Se abre el diálogo Add a Source to your application.
4. Selecciona Link to existing source, luego haz clic en Next.
5. Localiza la fuente de datos que creaste en el Paso 3, luego haz clic en Link 1 Source.
6. Revisa la actualización propuesta, luego haz clic en Done.

Paso 6: Vincular tu fuente de datos del conector local de App Builder y tu base de datos relacional

Vincular fuentes te permite crear reglas entre fuentes de datos en ambas direcciones:

• Para crear reglas con la base de datos relacional como fuente y tu fuente de datos del conector local de App Builder como destino:

  1. Navega a App Workbench de la aplicación que desees modificar.
  2. Ve a la pestaña Data Sources.
  3. Selecciona la base de datos relacional que deseas vincular. El panel lateral se completa con sus opciones.
  4. En el grupo de campos Business Logic Layer, haz clic en Link Sources. Se abre el diálogo Linked Data Sources.
  5. Haz clic en Create, luego selecciona la fuente de datos del conector local de App Builder que agregaste a tu aplicación en el Paso 5.
  6. Haz clic en el símbolo de verificación para guardar el registro.

Una vez vinculados, puedes usar tablas y objetos de negocio de la fuente de datos local de App Builder en reglas de negocio y reglas XP CRUD construidas en la base de datos relacional, incluidas reglas XP CRUD cuya fuente de datos es la base de datos relacional y cuyo destino es tu fuente de datos local de App Builder. Construye estas reglas XP CRUD en la base de datos relacional.

• Para construir reglas en la dirección opuesta, con tu conector local de App Builder como origen y la base de datos relacional como destino:

  1. Navega al App Workbench de la aplicación que deseas modificar.
  2. Ve a la pestaña Data Sources (Fuentes de datos).
  3. Selecciona el conector local de App Builder que deseas vincular. El panel lateral se completa con sus opciones.
  4. En el grupo de campos Business Logic Layer (Capa de lógica de negocio), haz clic en Link Sources (Vincular fuentes). Se abre el diálogo Linked Data Sources (Fuentes de datos vinculadas).
  5. Haz clic en Create (Crear) y luego selecciona la fuente de datos relacional a la que deseas conectar.
  6. Haz clic en el marca de verificación para guardar el registro.

  Una vez vinculados, puedes usar tablas y objetos de negocio de la base de datos relacional en reglas de negocio y reglas XP CRUD construidas en el conector local de App Builder, incluidas reglas XP CRUD cuya fuente de datos es la fuente de datos local de App Builder y cuyo destino es tu fuente de datos relacional. Construye estas reglas XP CRUD en el conector local de App Builder.

Conector remoto

Un conector remoto permite que una aplicación en un entorno de App Builder use un objeto compartido de un entorno de App Builder completamente separado, accesible en su propia URL, a través de HTTP. A diferencia de un conector local, los dos entornos no comparten un servidor, por lo que deben autenticarse mutuamente de forma explícita utilizando una clave API. Los pasos a continuación comparten un objeto en el entorno de origen primero, luego se conectan a él desde el remoto.

Esta sección cubre:

• Paso 1: Crear el objeto a compartir usando el conector de App Builder
• Paso 2: Habilitar conexiones remotas de App Builder
• Paso 3: Confirmar que se ha configurado un proveedor de seguridad de clave API
• Paso 4: Crear un rol para compartir el objeto
• Paso 5: Crear un grupo y otorgarle acceso
• Paso 6: Crear un usuario, generar una clave API y agregarlo al grupo
• Paso 7: Configurar la conexión desde el entorno remoto

Paso 1: Crear el objeto a compartir usando el conector de App Builder

Antes de que un entorno remoto pueda extraer datos de este, necesitas algo que compartir. Este paso crea una regla que define exactamente qué se expone:

1. Navega al App Workbench de la aplicación desde la que deseas compartir, luego ve a la pestaña Rules (Reglas).

2. Haz clic en + Rule (+ Regla). Se abre el Rule Builder (Constructor de reglas):

   • Name (Nombre): Asigna un nombre para la regla. Por ejemplo: Customer (Remote).
   • Purpose (Propósito): Selecciona Business Object (Objeto de negocio).
   • Target (Destino): Selecciona una tabla de destino para la regla. Por ejemplo: Customer.

3. Haz clic en Create (Crear).

4. En el panel Tables (Tablas), selecciona las columnas que deseas compartir.

5. En el panel Rule (Regla), ve a More (Más) > Edge Case. Se abre el diálogo Edge Case Settings (Configuración de casos especiales):

   

6. En Allow Public Access (Permitir acceso público), marca Read (Lectura) y/o Write (Escritura) según sea apropiado, para que el entorno remoto pueda acceder al objeto.

7. Haz clic en Proceed (Continuar).

Paso 2: Habilitar conexiones remotas de App Builder

Compartir un objeto no es suficiente por sí solo: la aplicación también debe estar explícitamente autorizada para aceptar solicitudes de conector remoto y, desde App Builder 4.67, estar asociada con los proveedores permitidos para autenticarlas:

1. Ve a IDE > Configuración adicional.

2. En el panel Configurar, haz clic en Remote Connector. Se abre el diálogo Orígenes de datos:

   

3. Marca la columna Permitir para la aplicación a la que quieres permitir conexiones remotas.

4. Haz clic en Continuar o en la marca de verificación .

5. (A partir de App Builder 4.67.) Haz clic en el botón Configurar autenticación de la aplicación. Se abre el diálogo Proveedores de autenticación. Agrega los proveedores de clave API, HTTP o servidor de autorización que quieras permitir para autenticar las solicitudes del Remote Connector. Consulta Configurar un extremo para conocer los pasos exactos.

   Nota

   Esta opción no está disponible en una aplicación sellada. Para una aplicación sellada, haz clic en el icono en su columna Servicio web en Aplicaciones, que abre este mismo diálogo Proveedores de autenticación desde fuera de la app.

Paso 3: Confirmar que un proveedor de seguridad de clave API esté configurado

El entorno remoto se autentica con este usando una clave API, así que confirma que este proveedor de seguridad exista y esté habilitado antes de generar una:

1. Ve a IDE > Proveedores de seguridad.
2. Confirma que haya un proveedor de seguridad Clave API habilitado configurado. Si no, configura uno (consulta Proveedor de seguridad - Clave API para aprender cómo hacerlo).

Paso 4: Crear un rol para compartir el objeto

Los pasos 4 al 6 son una práctica recomendada, no un requisito: limitan el acceso del entorno remoto solo al objeto que estás compartiendo, al crear un rol, grupo y usuario dedicados, y luego generar la clave API para ese usuario. Si los omites y generas una clave API para un usuario existente en su lugar, y el origen de datos de ese usuario no tiene roles configurados, la clave otorga acceso a cada objeto que marcaste como Permitir lectura y/o Permitir escritura en el Paso 1, no solo al que estás compartiendo aquí.

1. Dirígete al App Workbench de la app y luego ve a la pestaña Roles. Si la app tiene más de un origen de datos, selecciona el que pertenece al objeto compartido en el menú de origen de datos en la parte superior de la página.

2. Haz clic en + Rol (se muestra a continuación):

   

3. Se abre el diálogo Rol. Asigna un Nombre para el rol. Por ejemplo: Remote Connector.

4. Haz clic en Guardar. El panel Permisos queda disponible para interactuar:

   

5. Haz clic en + Permiso, selecciona el objeto que creaste en el Paso 1 y luego marca Leer, Insertar, Actualizar y/o Eliminar según sea necesario.

6. Haz clic en la marca de verificación para guardar.

Paso 5: Crear un grupo y otorgarle acceso

Crea un grupo dedicado para que el entorno remoto se autentique como:

1. Dirígete a IDE > Gestión de usuarios y luego selecciona la pestaña Grupos:

   

2. Haz clic en + Grupo. Se abre el diálogo Grupo:

   

3. Asigna un Nombre. Por ejemplo: Remote Connector.

4. Haz clic en Guardar.
5. Haz clic en Administrar privilegios. Se abren los paneles Privilegios y Roles.
6. En el panel Privilegios, haz clic en Crear. Se abre el diálogo Privilegio:

• Tipo: Selecciona Application.

• Application: Selecciona la aplicación que contiene el objeto que compartes. Por ejemplo: Global Imports.

• Haz clic en Save.

• En el panel Roles, localiza y haz clic en Grant para el rol que creaste en Paso 4.

Paso 6: Crear un usuario, generar una clave de API y agregarlo al grupo

Crea un usuario dedicado para que el entorno remoto se autentique y genera la credencial con la que se conecta:

1. Selecciona la pestaña Users:

   

2. Haz clic en + User. Se abre el diálogo User:

   

3. Asigna un User Name. Por ejemplo: RemoteConnector.

4. Haz clic en Save.
5. Haz clic en More > Keys.

6. Haz clic en Create. Se abre el diálogo Generate Key:

   

7. Selecciona API Key como Provider, luego haz clic en Save.

8. Copia el valor de Key generado a tu portapapeles.

   Precaución

   El valor de clave generado no se puede recuperar una vez que abandonas la pantalla Generate Key. Si lo pierdes, tendrás que generar uno nuevo.

9. Haz clic en + Membership, selecciona el grupo que creaste en Paso 5, luego haz clic en la marca de verificación para guardar.

Paso 7: Configurar la conexión desde el entorno remoto

Todos los pasos hasta ahora tuvieron lugar en el entorno que comparte el objeto. Este paso final cambia al entorno remoto y utiliza las credenciales que acabas de crear para establecer la conexión:

1. Navega al entorno remoto desde el que deseas conectarte, luego ve al App Workbench de la aplicación a la que deseas conectarte y selecciona la pestaña Data Sources.
2. Haz clic en + Source. Se abre un asistente para ayudarte.
3. En la primera pantalla del asistente, selecciona New Connection, luego haz clic en Next.

4. Selecciona Other como Connection Category, luego busca y selecciona App Builder Connector:

   

5. Haz clic en Next. El asistente omite el paso Choose Provider para este tipo de conexión e ir directamente a Create Connection.

6. Introduce los siguientes valores:

   

   • Server Name: Asigna un nombre. Por ejemplo: Remote.
   • App Builder Type: Confirma que está configurado en Remote.
   • Url: Introduce la URL del entorno al que te conectas. Por ejemplo: https://example.com.
   • Api Key: Pega el valor de clave que copiaste en Paso 6.

7. Haz clic en Next, luego continúa con los pasos restantes del asistente (Choose Database, Import Schema y Summary) para seleccionar la base de datos, importar las tablas, vistas y procedimientos almacenados a los que deseas conectarte, y confirmar la nueva conexión.

8. Selecciona la fuente de datos del conector remoto de App Builder, luego haz clic en Logic.
9. Haz clic en el icono Results para una entrada para confirmar que ves datos.
10. Prueba la conexión: edita un registro y guarda, luego regresa al otro entorno y confirma que la actualización también aparece allí.

Limitaciones

Ten en cuenta las siguientes limitaciones al trabajar con el conector de App Builder:

• El conector App Builder no es compatible con Reach.
• El conector App Builder es compatible con Full audit, pero se debe habilitar Full audit en la tabla subyacente para que funcione.
• Para un conector App Builder local, ambas bases de datos deben ser bases de datos relacionales y deben existir en el mismo entorno de servidor.
• Para un conector App Builder local, si se agregan o modifican columnas en una tabla pública u objeto de negocio, se deben mantener manualmente sincronizadas las tablas u objetos de negocio correspondientes en cada lado.

Solución de problemas

Error 403 Forbidden

• Síntoma: La conexión a un entorno App Builder remoto usando el conector App Builder devuelve un error 403 Forbidden.

• Posible causa: La cuenta de usuario configurada para el conector no tiene asignado el rol App Builder Remote Connector en el entorno App Builder de origen.

• Resolución: Asignar el rol App Builder Remote Connector a ese usuario. Consultar Paso 5: Crear un grupo y otorgarle acceso del conector remoto para conocer los pasos de configuración.

Response status code does not indicate success
at void Vinyl.Business.Application.Events.RemoteEventRunner.AssertSuccessStatusCode(HttpResponseMessage response, string uri, EventTableRef eventTableRef)
at async Task<EventTableRef> Vinyl.Business.Application.Events.RemoteEventRunner.Invoke(EventTableRef eventTableRef, VinylConnectorEndpoint connectorEndpoint)
at async Task<EventTableRef> Vinyl.Business.Application.Events.RemoteEventRunner.InvokeCountAsync(EventTableRef eventTableRef)
at async Task<EventTableRef> Vinyl.DataSource.VinylConnector.VinylConnectorDataSourceServerHandler.CountPublicDataSourcesAsync(EventContext eventContext)
at async Task Vinyl.DataSource.VinylConnector.VinylConnectorDataSourceServerHandler.PingAsync(EventContext eventContext, CancellationToken cancellationToken)
at async Task Vinyl.DataSource.Plugins.DataSourceManagement.PingDataSourceServer.InvokeAsync(ValidationRule validationRule, EventInputRow input)

Reason
Forbidden
Status
403
Uri
https://{{App BuilderRootURI}}/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
Vinyl.Business

Para solución de problemas relacionados, consultar App Builder Connector: No se puede recuperar la clave API generada después de salir de la pantalla en la guía de solución de problemas de App Builder.