Guía de Conexión de NetSuite¶

Descripción General¶

Esta guía describe los requisitos del sistema y las instrucciones para conectar Vinyl a un servidor de base de datos en la nube Oracle NetSuite. En esta guía se cubrirán dos componentes diferentes de NetSuite : Suite QL y SuiteTalk Web Services.

SuiteQL es un lenguaje de consultar basado en el lenguaje de consultar de la base de datos SQL y se utiliza para consultar datos de NetSuite. El servicio predeterminado admitido en SuiteTalk está diseñado utilizando una serie de solicitudes SOAP para recuperar datos en un formato más estrechamente asociado con la búsqueda guardada en NetSuite. Esto significa que SuiteQL se puede utilizar para manejar consultas mucho más complicadas que SuiteTalk. Por ejemplo, las uniones, agregaciones, agrupar por, ordenar por y fórmulas se pueden manejar desde el servidor utilizando SuiteQL.

SuiteTalk Web Services, por diseño, solo admite algunas uniones y predicados. En general, SuiteQL es una opción más poderosa para ejecutar consultas más rápido contra NetSuite debido a su soporte avanzado para el manejo de SQL.

Nuestra recomendación es utilizar Suite QL para lectura y creación de objetos y SuiteTalk para escritura y actualización de datos.

Para conectar sus servidores, debe tener instalado Vinyl 3.1.

Requisitos del Sistema¶

Servidor de Base de Datos¶

Oracle NetSuite

Navegador Web del Cliente¶

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

• Internet Explorer: 11+

Instrucciones de Conexión¶

Integración NetSuite¶

Antes de iniciar la configuración de Vinyl para la conexión, primero debes configurar una nueva integración en NetSuite. Esta configuración requiere acceso administrativo a NetSuite. Esta configuración de integración emitirá un ID de cliente y un secreto únicos, información necesaria para la configuración de Vinyl.

• Inicie sesión en NetSuite como administrador

  

• Vaya a Configuración > Integración > Administrar integración > Nuevo

  

• Al finalizar la configuración de integración, NetSuite generará un ID de cliente y un Secreto únicos. Asegúrese de almacenar esta información de forma segura, ya que solo puede recuperarla una vez y es necesaria para configurar la configuración de Vinyl.

Agregar un Servidor¶

1. Navegue hasta el Centro de control de Vinyl.

2. Haga clic en el enlace Conexiones del menú Conectar.

   

3. Haga clic en el botón Crear en la parte superior izquierda del panel Servidores de datos. Esto abrirá la página Agregar servidor.

Llenar Credenciales¶

Para conectarse a un servidor de base de datos NetSuite, proporcione la siguiente información:

• Nombre del servidor: un nombre de servidor único e identificable.

• Tipo: Seleccione "Net Suite" en el menú.

• Nombre de host: el nombre de host de su servidor.

• Puerto: El número de puerto del servidor. El puerto predeterminado es 1433.

• Nombre de la instancia: información requerida: esta es la parte de identificación de su URL única de NetSuite. Por ejemplo: < https://4201843.app.netsuite.com/ ? > se traduce como 4201843 como nombre de instancia.

  

• Configuración avanzada: Incluye opciones de configuración adicionales, incluida la configuración de Tiempo de espera de ping, que determina la cantidad de tiempo (en segundos) que Vinyl esperará un ping del servidor antes de declarar un tiempo de espera.

  • Avanzado: Este campo debe completarse correctamente para admitir la conexión

    • Esquema={{ Schema }}; //Esto está configurado en SuiteQL o SuiteTalk (Suite Talk se usa para escribir y actualizar datos). Tiene un esquema totalmente diferente al de SuiteQL.

    • OAuthClientId={{ OauthClientID }}; //Emitido cuando registra su integración NetSuite

    • OAuthClientSecret={{ OauthClientSecret }}; //Emitido cuando registra su integración NetSuite

    • OAuthAccessToken={{ AccessToken }}; //Emitir una llamada de prueba para generar esto inicialmente

    • OAuthAccessTokenSecret={{ AccessSecret }}; //Emitir una llamada de prueba para generar esto inicialmente

    • IncludeChildTables=true; // Parámetro opcional pero es obligatorio si el esquema está configurado en SuiteTalk y necesita escribir en tablas con relaciones para poder ver las subtablas

  Nota

  Se admiten parámetros adicionales, si es necesario. Estos se detallan en: https://cdn.cdata.com/help/DNG/ado/pg_suiteql.htm

• Tiempo de espera de ping: {el valor predeterminado es 10}

• Nombre del parámetro de consulta de escape: {el valor predeterminado está habilitado}

  

Después de completar todas las credenciales necesarias, haga clic en el botón Guardar para guardar la configuración.

Probando la Conexión¶

Haga clic en el botón Probar conexión debajo de la información del servidor para asegurarse de que el servidor esté conectado correctamente. Verá un mensaje de "Éxito" de Vinyl si la configuración es correcta.

Agregar una Fuente de Datos¶

Una vez guardada la configuración del servidor NetSuite, es necesario conectar la base de datos a Vinyl. Las bases de datos que están conectadas a Vinyl se denominan "fuente de datos".

1. Navegue hasta el Centro de control de Vinyl.

2. Haga clic en el enlace Conexiones del menú Conectar.

3. Haga clic para seleccionar la entrada del servidor NetSuite en el panel Servidores de datos, luego haga clic en Agregar una nueva fuente de datos > Crear nueva base de datos en el panel Fuentes de datos. Algunas fuentes de datos se importan automáticamente a la página de almacenamiento de datos de Vinyl. Si la fuente de datos ya se agregó, haga clic en el botón Detalles asociado para abrir la página de detalles.

4. Haga clic en el botón Editar

5. Complete las siguientes credenciales para la fuente de datos:

   1. Servidor de origen de datos: El nombre del servidor del que se extrae

   2. Nombre de la fuente de datos: asigne a la fuente de datos un nombre para mostrar único

   3. Importar patrón: esto permite a los usuarios importar solo ciertas tablas enumerándolas en el cuadro. Los prefijos también se pueden usar para importar solo un subconjunto de tablas (por ejemplo, MyApp_* solo importará tablas que comiencen con "MyApp_"). Si el espacio se deja en blanco, importará todas las tablas.

   

6. Haga clic en Guardar para actualizar la configuración de la fuente de datos.

7. Una vez que la página se actualice, haga clic en el botón Importar que aparece debajo de las credenciales de origen. Cuando se le solicite, haga clic en Continuar. La importación se programará para ejecutarse en segundo plano.

   

8. Una vez completada la importación, haga clic en Tablas para ver las tablas creadas actualmente.

Servicios Web NetSuite SuiteQL Frente a SuiteTalk¶

Como se indica en la sección Acerca de de esta guía, existen diferencias clave sobre cómo trabajará con NetSuite SuiteQL frente a los servicios web SuiteTalk en Vinyl, así como qué información se puede recuperar una vez establecida la conexión.

SuiteQL es un lenguaje de consultar basado en el lenguaje de consultar SQL. Admite capacidades de consultar avanzadas que puede aprovechar para ver registros y datos de NetSuite. Nuestra recomendación es utilizar SuiteQL para lectura y creación de objetos. Dentro de Vinyl, SuiteQL le permitirá mostrar Objetos como Vistas.

SuiteTalk Web Services es un servicio web basado en SOAP que se utiliza para la integración con sistemas externos, en este caso Vinyl. Por diseño, SuiteTalk solo admitirá algunas uniones y predicados.

Después de configurarlo correctamente en Vinyl, SuiteTalk le proporcionará una tabla de Extremos basados en Extremos SOAP en NetSuite.

Limitaciones¶

• NetSuite limita la simultaneidad de consultas que se ejecutan en él por conexión y licencias por grupo de conexiones, lo que afectará el rendimiento de lectura.

• NetSuite tiene algunas reglas personalizadas sobre filtros que necesitará para manipular su formato de datos para poder filtrar correctamente

• NetSuite no admite el uso de paréntesis en nombres de objetos