Saltar al contenido

App Builder Conector

Descripción General

App Builder el conector es una función diseñada para conectar dos dispositivos diferentes. App Builder instancias juntas y trátalas como una regla, importa la tabla y comienza a usarla.

Como desarrollador, puedes usar App Builder conector para conectar dos instancias diferentes que se ejecutan en el mismo ambiente (Local) o en dos ambientes diferentes a través de HTTP (Remoto). Pasos para configurar Local y Remoto App Builder en este artículo se proporcionan conectores.

Si está intentando resolver el problema an App Builder en el escenario de dependencia de LP, le recomendamos que utilice Herencia de tabla o extensión de tabla función y no utilizar la App Builder conector para resolver este problema. La función Extender tabla le permite seleccionar fácilmente las tablas que desea utilizar de otras fuentes de datos que residen en la misma instancia o ambiente, y no crea una dependencia de ninguna de las otras aplicaciones cuando está listo para agrupar y enviar su aplicación LP.

Un ejemplo de la App Builder escenario de dependencia de LP:
Tiene dos App Builder fuentes de datos que residen en la misma instancia o ambiente y está buscando unir entre la Fuente de datos A y la Fuente de datos B. Si su aplicación usa la Fuente de datos A y desea usar una tabla de la Fuente de datos B, y luego necesita enviar una versión de la aplicación A, que solo usa 1 tabla de la aplicación B, debe agrupar y enviar tanto la aplicación A como la B. Nuevamente, la forma recomendada de resolver este tipo de escenario es mediante el uso de Tablas extendidas. Esta es una solución mucho más sencilla y mejor de utilizar.

Advertencia

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

Local App Builder conector

El local App Builder el conector 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 Local App Builder conector

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

2. Creación de una Fuente de Datos Utilizando el Local App Builder conector

  • Desde el IDE, haga clic en Servidores de datos
  • Haga clic para seleccionar Servidores locales App Builder entrada del 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 nombres 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úblicos 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 utilizar una App Builder para conectarse a Northwinds, deberá crear dos fuentes de datos. Siguiendo nuestra convención de nombres, serían:

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

3. Permita el Acceso Público a las Tablas/objetos Comerciales Que Desea 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 de 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

Le recomendamos encarecidamente que no modifique la tabla pública o el objeto comercial 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. Importa Tablas/objetos de Negocio a Tu Conector

  • Vaya a IDE, haga clic en Servidores de datos
  • Haga clic para seleccionar Servidores locales App Builder entrada del panel Servidores de datos
  • Haga clic en el botón Detalles del panel Fuentes de datos
  • Haga clic en el botón Importar y, luego, en 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. Agrega Tu Local App Builder conector Como Fuente de Datos para 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 creada 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 Local App Builder fuente de datos del conector 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á utilizar tablas y objetos comerciales de la fuente de datos de Vinyl local en reglas comerciales y reglas CRUD de XP que se crean 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 de Vinyl local. Estas reglas CRUD de XP deberán crearse en la base de datos relacional.

  • Navegue hasta el App Workbench de la aplicación que desea modificar
  • Haga clic en el botón Fuentes de datos
  • Haga clic para seleccionar la fuente local App Builder conector 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á utilizar tablas y objetos comerciales de la base de datos relacional en reglas comerciales y reglas CRUD de XP que se crean en el conector de Vinyl local.

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

Conector Remoto

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

1. Crea el Objeto Que Deseas Compartir Usando App Builder conector

  • Navega hasta App Workbench desde la aplicación que deseas 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 el Control Remoto App Builder conexiones

  • Navegue hasta el IDE
  • Haga clic en el botón Configuración adicional
  • Haga clic en el botón Control remoto App Builder botón Conexiones
  • Marque la columna Permitir para la aplicación que desea permitir conexiones remotas App Builder conexiones
  • Haga clic en Continuar

3. Confirme Que un Proveedor de Seguridad de Clave API Esté Configurado

  • Navegar hasta el IDE
  • Haga clic en el botón Proveedores de seguridad
  • Confirme que haya un proveedor de seguridad con clave API habilitada configurado. Si no es así, debe 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 la aplicación App Builder conector remoto
  • 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 el valor, deberá generar un nuevo valor de clave.

6. Configuración Desde el Ambiente Remoto

  • Navegue hasta el ambiente remoto al que desea conectarse.
  • Vaya a 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
  • Localizar y seleccionar App Builder y haga clic en Siguiente
  • Asignar un Nombre de servidor. Por ejemplo: Remoto
  • Confirmar App Builder el tipo está configurado como Remoto
  • Pegue el valor de Api Key copiado en el paso 5
  • Ingrese el valor de URL del otro ambiente al que se está conectando. 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 Remoto App Builder fuente de datos del conector, luego 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

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

Nota

La mejor práctica es crear nuevos objetos comerciales que solo se utilizarán para el App Builder conector. Una vez que importe el objeto, solo debe cambiar el objeto público si es necesario. Si lo cambia, asegúrese de realizar el mismo cambio en el objeto local. App Builder conector.

Solución de Problemas

Error 403 Prohibido

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

Detalle completo del error:

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

Reason
Forbidden
Status
403
Uri
https://`a{{{{nm.ab}} URI raíz}}`/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
{{nm.ab_path}}.Business