Guía de conexión de NetSuite para Jitterbit App Builder

Descripción general

Esta guía describe los requisitos del sistema y las instrucciones para conectar App Builder a un servidor de base de datos en la nube de Oracle NetSuite. Se abordará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 bases de datos SQL y se utiliza para consultar datos de NetSuite. El servicio predeterminado compatible con SuiteTalk está diseñado mediante varias solicitudes SOAP para recuperar datos en un formato más similar a la búsqueda guardada en NetSuite. Esto significa que SuiteQL puede utilizarse para gestionar consultas mucho más complejas que SuiteTalk. Por ejemplo, las uniones, agregaciones, agrupar por, ordenar por y fórmulas se pueden gestionar desde el servidor con SuiteQL.

Los Servicios Web SuiteTalk, por diseño, solo admiten algunas uniones y predicados. En general, SuiteQL es una opción más potente para ejecutar consultas con mayor rapidez en NetSuite gracias a su compatibilidad avanzada con SQL.

Nuestra recomendación es utilizar Suite QL para leer y crear objetos y SuiteTalk para escribir y actualizar datos.

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 de NetSuite

Antes de configurar App Builder para la conexión, debe configurar una nueva integración en NetSuite. Esta configuración requiere acceso administrativo a NetSuite. Esta configuración de integración generará un ID de cliente y un secreto únicos, información necesaria para la configuración de App Builder.

Inicie sesión en NetSuite como administrador
Vaya a Configuración > Integración > Administrar integración > Nuevo

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

Agregar un servidor

Vaya al Centro de control del App Builder
Haga clic en el enlace Conexiones del menú Conectar
Haga clic en el botón Crear en la esquina superior izquierda del panel Servidores de Datos. Se abrirá la página Agregar Servidor.

Completar credenciales

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

Nombre del servidor: un nombre de servidor identificable y único.
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 obligatoria: este es el ID de su URL única de NetSuite. Por ejemplo: < https://4201843.app.netsuite.com/ > se traduce como 4201843 como nombre de la 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 App Builder 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 se configura en SuiteQL o SuiteTalk (SuiteTalk se usa para escribir y actualizar datos). Tiene un esquema totalmente diferente al de SuiteQL.
  - OAuthClientId={{ OauthClientID }}; //Se emite cuando registra su integración de NetSuite
  - OAuthClientSecret={{ OauthClientSecret }}; //Se emite cuando registra su integración de NetSuite
  - OAuthAccessToken={{ AccessToken }}; //Emite una llamada de prueba para generar esto inicialmente
  - OAuthAccessTokenSecret={{ AccessSecret }}; //Emite una llamada de prueba para generar esto inicialmente
  - IncludeChildTables=true; // Parámetro opcional, pero obligatorio si el esquema está configurado como SuiteTalk y se necesita escribir en tablas con relaciones para 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: {valor predeterminado: 10}
Nombre del parámetro de consulta de escape: {valor predeterminado: 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 comprobar que esté conectado correctamente. Si la configuración es correcta, verá un mensaje de "Conexión correcta" en App Builder.

Agregar una fuente de datos

Una vez guardada la configuración del servidor NetSuite, es necesario conectar la base de datos a App Builder. Las bases de datos conectadas a App Builder se denominan "fuentes de datos".

Vaya al Centro de control del App Builder
Haga clic en el enlace Conexiones del menú Conectar
Haga clic para seleccionar la entrada del servidor NetSuite en el panel Servidores de datos y, a continuación, 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 App Builder. Si la fuente de datos ya se ha agregado, haga clic en el botón Detalles correspondiente para abrir la página de detalles.
Haga clic en el botón Editar
Complete las siguientes credenciales para la fuente de datos:
1. Servidor de origen de datos: El nombre del servidor del que se extraen los datos
2. Nombre de la fuente de datos: Asigne a la fuente de datos un nombre para mostrar único
3. Patrón de importación: Esto permite a los usuarios importar solo ciertas tablas enumerándolas en el cuadro. También se pueden usar prefijos para importar solo un subconjunto de tablas (por ejemplo, MyApp_* solo importará las tablas que comiencen con "MyApp_"). Si se deja el espacio en blanco, se importarán todas las tablas.
Haga clic en Guardar para actualizar la configuración de la fuente de datos.
Una vez que la página se actualice, haga clic en el botón Importar que aparece debajo de las credenciales de la fuente. Cuando se le solicite, haga clic en Continuar. La importación se programará para ejecutarse en segundo plano.
Una vez finalizada la importación, haga clic en Tablas para ver las tablas creadas.

Servicios web SuiteQL de NetSuite frente a SuiteTalk

Como se señala en la sección Acerca de de esta guía, existen diferencias clave sobre cómo trabajará con NetSuite SuiteQL frente a SuiteTalk Web Services en App Builder, 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 funciones de consultar avanzadas que puede aprovechar para visualizar registros y datos de NetSuite. Recomendamos usar SuiteQL para la lectura y la creación de objetos. Dentro del propio App Builder, SuiteQL le permitirá mostrar objetos como vistas.

adjunto

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

Una vez configurado correctamente en App Builder, SuiteTalk le proporcionará Extremos de tabla basados en Extremos SOAP en NetSuite.

adjunto

Limitaciones

NetSuite limita la concurrencia de consultas que se ejecutan en él por conexión y licencias por grupo de conexiones, esto afectará el rendimiento de lectura
NetSuite tiene algunas reglas personalizadas sobre filtros que necesitará para manipular el formato de sus datos para poder filtrar correctamente.
NetSuite no admite el uso de paréntesis en los nombres de objetos