Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Esta documentación es para la versión 4 y posteriores de App Builder, el nuevo nombre de Vinyl. Accede a la documentación de Vinyl aquí.

✕

Conector de App Builder en Jitterbit App Builder

Descripción general

App Builder Connector 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 ejecutan en el mismo ambiente (Local) o en dos ambientes diferentes mediante HTTP (Remoto). En este artículo se detallan los pasos para configurar los Conectores de App Builder locales y remotos.

Si está intentando resolver un escenario de dependencia de LP de App Builder, le recomendamos que utilice Herencia de tabla o extensión de tabla y no usar el Conector de App Builder para solucionar esto. La función Extender Tabla permite seleccionar fácilmente las tablas que se desean usar de otras Fuentes de Datos que residen en la misma instancia o ambiente, y no crea dependencias con ninguna de las otras aplicaciones cuando se prepara para empaquetar y enviar la aplicación LP.

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 ambiente y buscas unir las fuentes de datos A y B. Si tu aplicación usa la fuente de datos A y quieres usar una tabla de la fuente de datos B, y luego necesitas enviar una versión de la aplicación A que solo usa una tabla de la aplicación B, necesitas agrupar y enviar las aplicaciones A y B. Nuevamente, la forma recomendada de resolver este tipo de escenario es usar Tablas extendidas esta es una solución mucho más sencilla y eficaz.

Advertencia

Por lo general, no se recomienda que ningún cliente trabaje con conectores de App Builder por su cuenta sin consultar primero con su consultor o contacto dedicado de Jitterbit.

Conector de App Builder local

El conector de Local App Builder se puede utilizar para establecer una conexión desde una fuente de datos relacionales a otra, dentro del mismo ambiente.

1. Creación de un conector de App Builder local

  • Desde el IDE, haga clic en Servidores de datos
  • Haga clic en + Servidor en el panel Servidores de datos
  • Nombre de su conexión al servidor
    • La convención de nomenclatura recomendada es nombrar el servidor '** App Builder local **'
  • Seleccione el tipo App Builder en la sección Configuración del servidor
  • Seleccione el tipo de App Builder Local
  • Haga clic en Guardar

2. Creación de una fuente de datos mediante el conector local de App Builder

  • Desde el IDE, haga clic en Servidores de datos
  • Haga clic para seleccionar la entrada Local App Builder en el panel Servidores de datos
  • Haga clic en el botón + Fuente del panel Fuentes de datos
  • Haga clic en + Crear base de datos
  • Nombre su fuente de datos en el campo Nombre de la base de datos
    • La convención de nomenclatura recomendada es nombrar la fuente de datos de la siguiente manera: [Data Source You're Connecting to] ([Application using the connector])
      • Por ejemplo: Si estuviera creando un conector local para Northwinds y lo conectara a una aplicación llamada Mi Aplicación, el nombre sería: Northwinds (Mi Aplicación)

  • Seleccione la fuente de datos a la que desea crear una conexión en el campo Nombre de la base de datos

    Nota

    Debe seleccionar una base de datos relacional. Se requiere una tabla/objeto de datos público en la fuente de datos para que se seleccione como base de datos.

  • Haga clic en Siguiente.

  • Revise las actualizaciones propuestas y haga clic en Listo.

Nota

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

Por ejemplo: Si tiene dos aplicaciones y desea usar una conexión local de App Builder para conectarse a Northwinds, deberá crear dos fuentes de datos. Siguiendo nuestra convención de nomenclatura, serían:

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

3. Permita el acceso público a las tablas/objetos comerciales que desee utilizar en su conector

  • Vaya al App Workbench de la aplicación que desea utilizar
  • Haga clic en el ficha Reglas de la capa empresarial
  • Seleccione la Fuente de datos de la aplicación para reflejar la fuente de datos que contiene las tablas que marcará con acceso público
  • Marque cualquier tabla o regla de negocio que desee utilizar en su conector como Públicas
    • Para marcar una tabla como Pública, haga clic en el ícono Abrir registro > haga clic en Más > Caso extremo > en el grupo Acceso público, marque para habilitar Permitir lectura y/o Permitir escritura
    • Para marcar una regla comercial como Pública, haga doble clic en la Regla para navegar a la página Definición de Regla > haga clic en Más > Caso Extremo > en el conjunto de controles Permitir Acceso Público, marque para habilitar Lectura y/o Escritura
      • Leer le permitirá leer los datos en esa tabla/objeto
      • Escribir le permitirá modificar la fecha en esa tabla/objeto

Nota

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

4. Importe tablas/objetos de negocio a su conector

  • Vaya a IDE, haga clic en Servidores de datos
  • Haga clic para seleccionar la entrada Local App Builder en el panel Servidores de datos
  • Haga clic en el botón Detalles del panel Fuentes de datos
  • Haga clic en el botón Importar y Importar nuevamente desde Capacidades de importación para importar todas las tablas que marcó como públicas O escriba el nombre de la tabla/objeto comercial en el Patrón de importación para importar solo un subconjunto de las tablas/objetos comerciales públicos
  • Haga clic en Continuar y se ejecutará un trabajo en segundo plano para ejecutar la tarea.

5. Agregue su conector local de App Builder como fuente de datos a su aplicación

  • Vaya al App Workbench de la aplicación que desea modificar
  • Haga clic en el ficha Fuentes de datos
  • Haga clic en + Fuente
  • Seleccione Enlace a fuente existente
  • Haga clic en Siguiente
  • Localice la fuente de datos nombrada en el paso 2 y haga clic en Vincular fuente
  • Revise la actualización propuesta y haga clic en Listo
  • Vaya al App Workbench de la aplicación que desea modificar
  • Haga clic en el botón Fuentes de datos
  • Haga clic para seleccionar la base de datos relacional a la que desea enlace
  • Haga clic en el botón Vincular fuentes para la fuente de datos seleccionada
  • Haga clic en Crear y seleccione la fuente de datos del conector de App Builder local que agregó a su aplicación en el paso 6
  • Haga clic en la marca de verificación para guardar el registro

Nota

Esto le permitirá usar tablas y objetos de negocio de la fuente de datos local de vinilo en reglas de negocio y reglas CRUD de XP creadas en la base de datos relacional.

Esto también le permitirá crear reglas CRUD de XP con la fuente de datos de origen de la base de datos relacional y la fuente de datos de destino de su fuente de datos local de vinilo. Estas reglas CRUD de XP deberán crearse en la base de datos relacional.

  • Vaya al App Workbench de la aplicación que desea modificar
  • Haga clic en el botón Fuentes de datos
  • Haga clic para seleccionar el conector de Local App Builder al que desea enlace
  • Haga clic en el botón Vincular fuentes para la fuente de datos seleccionada
  • Haga clic en Crear y seleccione la fuente de datos relacionales a la que desea conectarse
  • Haga clic en la marca de verificación para guardar el registro

Nota

Esto le permitirá usar tablas y objetos de negocio de la base de datos relacional en reglas de negocio y reglas CRUD de XP integradas en el conector local de Vinyl.

Esto también le permitirá crear reglas CRUD de XP con la fuente de datos de origen de la fuente de datos local de Vinyl y la fuente de datos de destino de su fuente de datos relacional. Estas reglas CRUD de XP deberán integrarse en la base de datos relacional.

Conector remoto

El conector de Remote App Builder se puede utilizar para establecer una conexión desde un ambiente de App Builder a otro a través de HTTP.

1. Cree el objeto para compartir mediante el conector de App Builder

  • Vaya al App Workbench desde la aplicación que desea compartir.
  • Haga clic en + Regla
  • Asigna un Nombre a la regla. Por ejemplo: Cliente (Remoto)
  • Establezca el Propósito. Por ejemplo: Objeto de negocio
  • Confirmar el Objetivo. Por ejemplo: Cliente
  • Haga clic en Crear
  • Desde la pestaña Tablas, haga clic para seleccionar las columnas que desea mostrar
  • Vaya a Más > Caso extremo
  • En Permitir acceso público, marque para habilitar Lectura y/o Escritura según corresponda
  • Haga clic en Continuar

2. Habilitar conexiones remotas de App Builder

  • Navegar hasta el IDE
  • Haga clic en el botón Configuración adicional
  • Haga clic en el botón Conexiones de Remote App Builder
  • Marque la columna Permitir para la aplicación a la que desea permitir conexiones remotas de App Builder
  • Haga clic en Continuar

3. Confirme que esté configurado un proveedor de seguridad de clave API

  • Navegar hasta el IDE
  • Haga clic en el botón Proveedores de seguridad
  • Confirme que haya un proveedor de seguridad con clave API habilitada y configurado. De lo contrario, deberá configurar uno.
  • Vea Proveedor de seguridad - Clave API para más información

4. Crea un rol para compartir el objeto

  • Vaya al App Workbench para la aplicación
  • Haga clic en el ficha Roles
  • Haga clic en + Rol
  • Asignar un Nombre. Por ejemplo: Conector Remoto
  • Haga clic en Guardar
  • Haga clic en el botón + Permiso
  • Seleccione el objeto creado en el paso 1
  • Haga clic en la marca de verificación para guardar

Nota

Para obtener más información sobre los roles, consulte Privilegios y permisos.

5. Crea un grupo y un usuario

  • Navegar hasta el IDE
  • Haga clic en el botón Administración de usuarios
  • Seleccione la pestaña de navegación Grupos
  • Haga clic en + Grupo
  • Asignar un Nombre. Por ejemplo: Conector Remoto
  • Haga clic en Administrar privilegios > Crear
  • Seleccione Aplicación como Tipo
  • Seleccione la Aplicación adecuada en el menú. Por ejemplo: Importaciones Globales
  • Haga clic en Guardar
  • Haga clic en Crear
  • Seleccione Aplicación como Tipo
  • Seleccione la Aplicación adecuada en el menú. Por ejemplo: App Builder
  • Haga clic en el botón Otorgar que aparece para la aplicación seleccionada en el paso anterior
  • Haga clic en el botón Otorgar para el conector remoto de App Builder
  • Haga clic en la pestaña de navegación Usuarios y haga clic en + Usuario
  • Asignar un Nombre de usuario. Por ejemplo, RemoteConnector
  • Haga clic en Guardar
  • Haga clic en el botón Más y seleccione Teclas
  • Haga clic en el botón Crear
  • Seleccione la Clave API como Proveedor y haga clic en Guardar
  • Copiar el valor Clave generado al portapapeles.
  • Haga clic en + Membresía
  • Seleccione el Grupo creado (Conector remoto) y haga clic en la marca de verificación para guardar

Precaución

El valor de la clave generada no se puede recuperar después de salir de la pantalla Generar clave. Si se pierde, deberá generar una nueva.

6. Configuración desde el ambiente remoto

  • Navegue hasta el ambiente remoto al que desea conectarse.
  • Vaya al App Workbench desde la aplicación que desea conectar
  • Haga clic en el ficha Fuentes de datos
  • Haga clic en + Fuente
  • Seleccione Nueva conexión y haga clic en Siguiente
  • Seleccione Otro como la Categoría de conexión
  • Localice y seleccione App Builder y haga clic en Siguiente
  • Asignar un Nombre de Servidor. Por ejemplo: Remoto
  • Confirme que el Tipo de App Builder esté configurado como Remoto
  • Pegue el valor de Api Key copiado en el paso 5
  • Introduce el valor de la URL del otro ambiente al que te conectas. Por ejemplo: https://example.com
  • Haga clic en Siguiente, Siguiente
  • Haga clic en Importar esquema para las tablas, vistas y procedimientos almacenados que desea conectar
  • Haga clic en Siguiente y revise las actualizaciones propuestas, luego haga clic en Listo
  • Seleccione Fuente de datos del conector de Remote App Builder * y, a continuación, haga clic en *Lógica**
  • Haga clic en el ícono Resultados de una entrada que aparezca para confirmar que ve los datos
  • Pruebe a editar un registro de datos, guárdelo y vuelva al otro ambiente y confirme que ahora ve la actualización.

Limitaciones y avisos

  • El conector de App Builder no es compatible con Reach
  • App Builder Connector admite Auditoría, pero esta debe estar habilitada en la tabla subyacente para que funcione
  • Para el conector de Local App Builder, ambas bases de datos deben ser bases de datos relacionales y existir en el mismo ambiente de servidor.
  • Para el conector de Local App Builder, si agrega o modifica columnas a tablas públicas u objetos comerciales, deberá mantener manualmente las tablas u objetos comerciales sincronizados.

Nota

La mejor práctica es crear nuevos objetos de negocio que solo se usarán para el conector de App Builder. Una vez importado el objeto, solo debe modificar el objeto público si es necesario. Si lo modifica, asegúrese de realizar el mismo cambio en el conector de App Builder local.

Solución de problemas

Error 403 prohibido

Si recibe un mensaje de error 403 Prohibido con el Conector de App Builder, compruebe que le haya otorgado a su usuario el rol "Conector Remoto de App Builder ". Consulte la sección "Crear un grupo y un usuario" de este artículo para obtener información sobre la configuración.

Detalle completo 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://{{URI raíz del constructor de aplicaciones}}`/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
Vinyl.Business