Saltar al contenido

Conectores de Vinyl

Descripción General

Vinyl Connector es una función diseñada para conectar dos instancias de Vinyl diferentes y tratarlas como una regla, importar la tabla y comenzar a usarla.

Como desarrollador, puedes utilizar Vinyl Connector para conectar dos instancias diferentes que se ejecutan en el mismo ambiente (Local) o en dos ambientes diferentes a través de HTTP (Remoto). En este artículo se proporcionan los pasos para configurar conectores de Vinyl locales y remotos.

Si está intentando solucionar un escenario de dependencia de Vinyl LP, le recomendamos que utilice Table Inheritance o Extend Table cuentan y no usan el conector de Vinyl para solucionar este problema. La función Extender tabla le permite seleccionar fácilmente las tablas que desea usar 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án listas para agruparse y enviarse. tu aplicación LP.

Un ejemplo del escenario de dependencia de Vinyl LP:
Tiene dos fuentes de datos de Vinyl 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, entonces debe 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. Aquí 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 simple y mejor de usar.

Advertencia

Por lo general, no se recomienda que ningún cliente trabaje con Vinyl Connectors por su cuenta sin consultar con su asesor exclusivo de Jitterbit o contactarse primero.

Conector de Vinyl Local

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

1. Crear un Conector de Vinyl Local

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

2. Crear una Fuente de Datos Utilizando el Conector de Vinyl Local

  • Desde el IDE, haga clic en Servidores de datos
  • Haga clic para seleccionar la entrada Vinyl local del panel Servidores de datos
  • Haga clic en el botón + Fuente del panel Fuentes de datos
  • Haga clic en + Crear base de datos
  • Asigne un nombre a 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 conectándolo 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 conexión Vinyl local para conectarse a Northwinds, creará dos fuentes de datos. Siguiendo nuestra convención de nomenclatura, serían:

  • Vientos del norte (Mi aplicación 1)
  • Vientos del norte (Mi aplicación 2)

3. Permita el Acceso Público a las Tablas/objetos Comerciales Que Desea Utilizar en Su Conector

  • Navegue hasta App Workbench para la aplicación que desea usar
  • Haga clic en el ficha Reglas de la capa empresarial
  • Seleccione Fuente de datos de la aplicación para reflejar la fuente de datos que contiene las tablas que marcará con acceso público.
  • Marque las tablas o reglas comerciales 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 > Edge Case > 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 límite > en el conjunto de control Permitir acceso público, marque para habilitar Leer y/o Escribir
      • 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/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. Importe Tablas/objetos Comerciales a Su Conector

  • Navegue hasta IDE, haga clic en Servidores de datos
  • Haga clic para seleccionar la entrada Vinyl local 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 Importar nuevamente desde Importar capacidades para importar todas las tablas que marcó como públicas O escriba el nombre de la tabla/el nombre del objeto comercial en Importar patró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 de Vinyl Local Como Fuente de Datos a Su Aplicación

  • Navegue hasta App Workbench para 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 creada en el paso 2 y haga clic en Vincular fuente
  • Revise la actualización propuesta y haga clic en Listo
  • Navegue hasta App Workbench para 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 Vinyl 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á utilizar tablas y objetos comerciales de la fuente de datos de Vinyl local en reglas comerciales y reglas XP CRUD que se crean en la base de datos relacional.

Esto también le permitirá crear reglas XP CRUD 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 App Workbench para la aplicación que desea modificar
  • Haga clic en el botón Fuentes de datos
  • Haga clic para seleccionar el conector de Vinyl local 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 XP CRUD que están integradas en el conector de Vinyl local.

Esto también le permitirá crear reglas XP CRUD 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 de Vinyl Remoto

El conector remoto de Vinyl se puede utilizar para establecer una conexión de un ambiente Vinyl a otro a través de HTTP.

1. Crea el Objeto para Compartir Usando Vinyl Connector

  • Navegue hasta App Workbench desde la aplicación desde la que desea compartir
  • Haga clic en + Regla
  • Asigne un Nombre para la regla. Por ejemplo: Cliente (Remoto)
  • Establece el Propósito. Por ejemplo: objeto de negocio
  • Confirma 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 > Edge Case
  • En Permitir acceso público, marque para habilitar Leer y/o Escribir según corresponda.
  • Haga clic en Continuar

2. Habilite las Conexiones Remotas de Vinyl

  • Navega hasta IDE
  • Haga clic en el botón Configuraciones adicionales
  • Haga clic en el botón Conexiones remotas de Vinyl
  • Marque la columna Permitir para la aplicación que desea permitir conexiones remotas de Vinyl.
  • Haga clic en Continuar

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

  • Navega hasta IDE
  • Haga clic en el botón Proveedores de seguridad
  • Confirme que haya un proveedor de seguridad * Clave API * habilitado configurado. Si no, es necesario configurar uno.
  • Consulte Proveedor de seguridad - Clave API para más información

4. Crea un Rol para Compartir el Objeto.

  • Navegue hasta App Workbench para la aplicación
  • Haga clic en el ficha Roles
  • Haga clic en + Rol
  • Asigne un Nombre. Por ejemplo: conector remoto
  • 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 Roles, consulte Privilegios y permisos.

5. Cree un Grupo y un Usuario

  • Navega hasta IDE
  • Haga clic en el botón Administración de usuarios
  • Seleccione la pestaña de navegación Grupos
  • Haga clic en + Grupo
  • Asigne un Nombre. Por ejemplo: conector remoto
  • Haga clic en Administrar privilegios > Crear
  • Seleccione Aplicación como Tipo
  • Seleccione la Aplicación apropiada en el menú. Por ejemplo: Importaciones globales
  • Clic en Guardar**
  • Haga clic en Crear
  • Seleccione Aplicación como Tipo
  • Seleccione la Aplicación apropiada en el menú. Por ejemplo: Vinyl
  • 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 Vinyl.
  • Haga clic en la pestaña de navegación Usuarios y haga clic en + Usuario
  • Asigne un Nombre de usuario. Por ejemplo conector remoto
  • Clic en Guardar**
  • Haga clic en el botón Más y seleccione Claves
  • Haga clic en el botón Crear
  • Seleccione la Clave API como Proveedor y haga clic en Guardar
  • Copie el valor de 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 clave generado no se puede recuperar después de salir de la pantalla Generar clave. Si se pierde el valor, deberá generar un nuevo valor 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 conectarse
  • Haga clic en el ficha Fuentes de datos
  • Haga clic en + Fuente
  • Seleccione Nueva conexión y haga clic en Siguiente
  • Seleccione Otro como Categoría de conexión
  • Busque y seleccione Vinyl y haga clic en Siguiente
  • Asigne un Nombre de servidor. Por ejemplo: remoto
  • Confirma que Tipo de Vinyl esté configurado en Remoto
  • Pegue el valor de Api Key copiado en el paso 5.
  • Ingrese el valor Url para el 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 Fuente de datos del conector de Vinyl remoto y luego haga clic en Lógica
  • Haga clic en el icono Resultados para que aparezca una entrada que confirme que ve los datos.
  • Pruebe a editar un registro de datos, guarde y navegue de regreso al otro ambiente y confirme que ahora ve la actualización.

Limitaciones y Avisos

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

Nota

La mejor práctica es crear nuevos objetos comerciales que solo se utilizarán para Vinyl Connector. 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 conector de Vinyl local.

Solución de Problemas

Error 403 Prohibido

Si recibe un mensaje de error 403 Prohibido con Vinyl Connector, verifique que le haya otorgado a su usuario la rol"Vinyl Remote Connector". Consulte la sección Crear un grupo y un usuario de este artículo para obtener información sobre cómo configurar.

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://{{VinylRootURI}}/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
Vinyl.Business