Saltar al contenido

Conector de App Builder en Jitterbit App Builder

Descripción general

El Conector de App Builder es una función diseñada para conectar dos instancias diferentes de App Builder y tratarlas como una Regla, importar la Tabla y comenzar a usarla.

Como Desarrollador, puedes usar el Conector de App Builder para conectar dos instancias diferentes que se están ejecutando en el mismo entorno (Local) o a través de dos entornos diferentes por HTTP (Remoto). Los pasos para configurar Conectores de App Builder Locales y Remotos se proporcionan en este artículo.

Si estás tratando de resolver un escenario de dependencia de LP de App Builder, te recomendamos que utilices la función de Herencia de Tabla o Tabla Extendida y no uses el Conector de App Builder para resolver esto. La función de Tabla Extendida te permite seleccionar fácilmente tablas que deseas usar de otras Fuentes de Datos que residen en la misma instancia o entorno, y no crea una dependencia en ninguna de las otras aplicaciones cuando estés listo para empaquetar y enviar tu LP de aplicación.

Un ejemplo del escenario de dependencia de LP de App Builder:
Tienes dos Fuentes de Datos de App Builder que residen en la misma instancia o entorno y estás buscando unir entre la Fuente de Datos A y la Fuente de Datos B. Si tu aplicación está utilizando la Fuente de Datos A y deseas usar una tabla de la Fuente de Datos B, y luego necesitas enviar una versión de la aplicación A, que solo usa 1 tabla de la aplicación B, necesitas empaquetar y enviar ambas aplicaciones A y B. Aquí nuevamente, la forma recomendada de resolver este tipo de escenario es utilizando Tablas Extendidas. Esta es una solución mucho más simple y mejor de usar.

Advertencia

Generalmente no se recomienda que ningún cliente trabaje con Conectores de App Builder por su cuenta sin consultar primero con su consultor dedicado de Jitterbit o contacto.

Conector de App Builder Local

El Conector de App Builder Local se puede usar para establecer una conexión de una fuente de datos relacional a otra, dentro del mismo entorno.

1. Creando un conector de App Builder local

  • Desde el IDE, haz clic en Servidores de Datos
  • Haz clic en + Servidor en el panel de Servidores de Datos
  • Nombra tu conexión de servidor
    • La mejor práctica de nomenclatura es nombrar el servidor 'App Builder Local'
  • Selecciona el Tipo App Builder en la sección de Configuración del Servidor
  • Selecciona el Tipo de App Builder Local
  • Haz clic en Guardar

2. Creando una fuente de datos utilizando el conector de App Builder local

  • Desde el IDE, haz clic en Servidores de Datos
  • Haz clic para seleccionar la entrada App Builder Local en el panel de Servidores de Datos
  • Haz clic en el botón + Fuente en el panel de Fuentes de Datos
  • Haz clic en + Crear Base de Datos
  • Nombra tu Fuente de Datos en el campo Nombre de la Base de Datos
    • La mejor práctica de nomenclatura es nombrar la Fuente de Datos de la siguiente manera: [Fuente de Datos a la que te estás conectando] ([Aplicación que utiliza el conector])
      • Por ejemplo: Si estuvieras creando un conector local para Northwinds y conectándolo a una aplicación llamada Mi Aplicación, el nombre sería: Northwinds (Mi Aplicación)

  • Selecciona la Fuente de Datos a la que deseas crear una conexión en el campo Nombre de la Base de Datos

    Nota

    Debes seleccionar una base de datos relacional. Se requiere una tabla/objeto de datos público en la Fuente de Datos para que pueda ser seleccionada como la Base de Datos.

  • Haz clic en Siguiente

  • Revisa las actualizaciones propuestas y haz clic en Listo

Nota

Recomendamos crear una fuente de datos diferente cada vez que desees conectar tu aplicación a otra base de datos relacional.

Por ejemplo: Si tienes dos aplicaciones y deseas usar una Conexión de App Builder local para conectarte a Northwinds, crearías dos fuentes de datos. Siguiendo nuestra convención de nomenclatura, serían:

  • Northwinds (Mi Aplicación 1)
  • Northwinds (Mi Aplicación 2)

3. Permitir acceso público a las tablas/objetos de negocio que deseas usar en tu conector

  • Navega a la App Workbench para la aplicación que deseas usar
  • Haz clic en el mosaico de Reglas de Capa Empresarial
  • Selecciona la Fuente de Datos de la Aplicación para reflejar la fuente de datos que contiene las tablas que marcarás con Acceso Público
  • Marca cualquier Tabla o Regla Empresarial que desees usar en tu conector como Pública
    • Para marcar una tabla como Pública, haz clic en el ícono de Abrir Registro > haz clic en Más > Caso Especial > en el grupo de Acceso Público, marca para habilitar Permitir Lectura y/o Permitir Escritura
    • Para marcar una regla empresarial como Pública, haz doble clic en la Regla para navegar a la página de Definición de la Regla > haz clic en Más > Caso Especial > en el control de Permitir Acceso Público, marca para habilitar Lectura y/o Escritura
      • Lectura te permitirá leer los datos en esa tabla/objeto
      • Escritura te permitirá modificar la fecha en esa tabla/objeto

Nota

Recomendamos encarecidamente que no modifiques la tabla/objeto empresarial público una vez que se haya hecho público y utilizado en un conector. Consulta la sección de limitaciones a continuación para más información.

4. Importar tablas/objetos empresariales en tu conector

  • Navega a IDE, haz clic en Servidores de Datos
  • Haz clic para seleccionar la entrada de Constructor de Aplicaciones Local del panel de Servidores de Datos
  • Haz clic en el botón de Detalles del panel de Fuentes de Datos
  • Haz clic en el botón de Importar, y Importar nuevamente desde Capacidades de Importación para importar todas las tablas que marcaste como públicas O escribe el nombre de la tabla/nombre del objeto empresarial en el Patrón de Importación para importar solo un subconjunto de las Tablas/Objetos Empresariales públicos
  • Haz clic en Proceder y se ejecutará un trabajo en segundo plano para llevar a cabo la tarea

5. Agregar tu conector de Constructor de Aplicaciones Local como fuente de datos a tu aplicación

  • Navega a la App Workbench para la aplicación que deseas modificar
  • Haz clic en el mosaico de Fuentes de Datos
  • Haz clic en + Fuente
  • Selecciona Vincular a fuente existente
  • Haz clic en Siguiente
  • Localiza la Fuente de Datos nombrada creada en el paso 2, y haz clic en Vincular Fuente
  • Revisa la actualización propuesta y haz clic en Listo
  • Navega a la App Workbench para la aplicación que deseas modificar
  • Haz clic en el botón Fuentes de Datos
  • Haz clic para seleccionar la base de datos relacional a la que deseas vincularte
  • Haz clic en el botón Vincular Fuentes para la fuente de datos seleccionada
  • Haz clic en Crear y selecciona la fuente de datos del Conector de App Builder Local que agregaste a tu aplicación en el Paso 6
  • Haz clic en el checkmark para guardar el registro

Nota

Esto te permitirá usar tablas y objetos de negocio de la fuente de datos del App Builder local en reglas de negocio y reglas XP CRUD que se construyen en la base de datos relacional.

Esto también te permitirá crear reglas XP CRUD con la fuente de datos de la base de datos relacional y la fuente de datos de tu fuente de datos del App Builder local. Estas reglas XP CRUD deberán ser construidas en la base de datos relacional.

  • Navega a la App Workbench para la aplicación que deseas modificar
  • Haz clic en el botón Fuentes de Datos
  • Haz clic para seleccionar el conector de App Builder local al que deseas vincularte
  • Haz clic en el botón Vincular Fuentes para la fuente de datos seleccionada
  • Haz clic en Crear y selecciona la fuente de datos relacional a la que deseas conectarte
  • Haz clic en el checkmark para guardar el registro

Nota

Esto te permitirá usar tablas y objetos de negocio de la base de datos relacional en reglas de negocio y reglas XP CRUD que se construyen en el conector de App Builder local.

Esto también te permitirá crear reglas XP CRUD con la fuente de datos de la fuente de datos de vinilo local y la fuente de datos de tu fuente de datos relacional. Estas reglas XP CRUD deberán ser construidas en la base de datos relacional.

Conector remoto

El Conector de App Builder Remoto se puede usar para establecer una conexión de un entorno de App Builder a otro a través de HTTP.

1. Crear el objeto para compartir usando el conector de App Builder

  • Navega al App Workbench desde la aplicación de la que deseas compartir
  • Haz clic en + Regla
  • Asigna un Nombre para la regla. Por ejemplo: Cliente (Remoto)
  • Establece el Propósito. Por ejemplo: Objeto de Negocio
  • Confirma el Objetivo. Por ejemplo: Cliente
  • Haz clic en Crear
  • Desde la pestaña de Tablas, haz clic para seleccionar las columnas que deseas mostrar
  • Ve a Más > Caso Especial
  • Desde Permitir Acceso Público, marca para habilitar Lectura y/o Escritura según corresponda
  • Haz clic en Continuar

2. Habilitar conexiones remotas de App Builder

  • Navega al IDE
  • Haz clic en el botón de Configuraciones Adicionales
  • Haz clic en el botón de Conexiones Remotas de App Builder
  • Marca la columna de Permitir para la aplicación a la que deseas permitir conexiones remotas de App Builder
  • Haz clic en Continuar

3. Confirmar que un proveedor de seguridad de clave API está configurado

  • Navega al IDE
  • Haz clic en el botón de Proveedores de Seguridad
  • Confirma que hay un proveedor de seguridad Clave API habilitado configurado. Si no, se necesita configurar uno.
  • Consulta Proveedor de seguridad - clave API para más información

4. Crear un rol para compartir el objeto

  • Navega al App Workbench para la aplicación
  • Haz clic en el mosaico de Roles
  • Haz clic en + Rol
  • Asigna un Nombre. Por ejemplo: Conector Remoto
  • Haz clic en Guardar
  • Haz clic en el botón de + Permiso
  • Selecciona el objeto creado en el paso 1
  • Haz clic en el checkmark para guardar

Nota

Para más información sobre Roles, consulta Privilegios y permisos.

5. Crear un grupo y un usuario

  • Navega al IDE
  • Haz clic en el botón de Gestión de Usuarios
  • Selecciona la pestaña de navegación Grupos
  • Haz clic en + Grupo
  • Asigna un Nombre. Por ejemplo: Conector Remoto
  • Haz clic en Gestionar Privilegios > Crear
  • Selecciona Aplicación como el Tipo
  • Selecciona la Aplicación apropiada del menú. Por ejemplo: Importaciones Globales
  • Haz clic en Guardar
  • Haz clic en Crear
  • Selecciona Aplicación como el Tipo
  • Selecciona la Aplicación apropiada del menú. Por ejemplo: App Builder
  • Haz clic en el botón de Conceder que aparece para la aplicación seleccionada en el paso anterior
  • Haz clic en el botón de Conceder para el Conector Remoto de App Builder
  • Haz clic en la pestaña de navegación Usuarios y haz clic en + Usuario
  • Asigna un Nombre de Usuario. Por ejemplo: ConectorRemoto
  • Haz clic en Guardar
  • Haz clic en el botón de Más y selecciona Claves
  • Haz clic en el botón de Crear
  • Selecciona la Clave API como el Proveedor y haz clic en Guardar
  • Copia el valor de Clave generado al portapapeles.
  • Haz clic en + Membresía
  • Selecciona el Grupo creado (Conector Remoto) y haz clic en el checkmark para guardar

Advertencia

El valor de la clave generada no se puede recuperar después de salir de la pantalla Generar clave. Si se pierde el valor, necesitarás generar un nuevo valor de clave.

6. Configuración desde el entorno remoto

  • Navega al entorno remoto al que deseas conectarte
  • Ve al App Workbench desde la aplicación a la que deseas conectarte
  • Haz clic en el mosaico Data Sources
  • Haz clic en + Source
  • Selecciona New Connection y haz clic en Next
  • Selecciona Other como la Categoría de Conexión
  • Localiza y selecciona App Builder y haz clic en Next
  • Asigna un Nombre de Servidor. Por ejemplo: Remoto
  • Confirma que el Tipo de App Builder esté configurado como Remote
  • Pega el valor de Api Key copiado en el paso 5
  • Ingresa el valor de Url para el otro entorno al que te estás conectando. Por ejemplo: https://example.com
  • Haz clic en Next, Next
  • Haz clic en Import Schema para las tablas, vistas y procedimientos almacenados a los que deseas conectarte
  • Haz clic en Next y revisa las actualizaciones propuestas, luego haz clic en Done
  • Selecciona Remote App Builder Connector Data Source, luego haz clic en Logic
  • Haz clic en el ícono de Results para una entrada que aparezca para confirmar que ves datos
  • Prueba hacer una edición a un registro de datos, guarda y navega de regreso al otro entorno y confirma que ahora ves la actualización

Limitaciones y advertencias

  • El App Builder Connector no soporta Reach
  • El App Builder Connector soporta Auditoría, pero la Auditoría debe estar habilitada en la tabla subyacente para que funcione
  • Para el Local App Builder Connector, ambas bases de datos deben ser bases de datos relacionales y existir en el mismo entorno de servidor.
  • Para el Local App Builder Connector, si agregas/modificas columnas en tablas públicas u objetos de negocio, necesitarás mantener manualmente las tablas/objetos de negocio sincronizados.

Nota

La mejor práctica es crear nuevos Objetos de Negocio que solo se utilizarán para el App Builder Connector. Una vez que importes el objeto, solo deberías cambiar el objeto público si es necesario. Si lo cambias, asegúrate de hacer el mismo cambio en el Local App Builder Connector.

Solución de problemas

Error 403 prohibido

Si recibe un mensaje de error 403 Prohibido con el Conector de App Builder, verifique si le otorgó a su usuario el rol de "Conector Remoto de App Builder". Consulte la sección Crear un grupo y usuario de este artículo para obtener información sobre cómo configurarlo.

Detalles completos del error:

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