Guía de Conexión de NetSuite¶

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 Oracle NetSuite. En esta guía se tratará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 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 gestionar consultas mucho más complicadas que SuiteTalk. Por ejemplo, las uniones, las agregaciones, la agrupación por, el orden por y las fórmulas se pueden gestionar desde el lado del servidor utilizando SuiteQL.

SuiteTalk Web Services, por diseño, solo admite algunas uniones y predicados. En general, SuiteQL es una opción más potente para ejecutar consultas más rápido en NetSuite debido a su compatibilidad avanzada para manejar 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+

• Ventaja: 84+

• Internet Explorer: 11+

Instrucciones de Conexión¶

Integración con NetSuite¶

Antes de comenzar el App Builder para configurar la conexión, primero debe 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 conexión. App Builder configuración.

• 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 almacenar esta información de forma segura, ya que solo puede obtenerla una vez y es necesaria para configurar la App Builder configuración.

Agregar un Servidor¶

1. Navegue hasta la App Builder Centro de control

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.

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: esta es la parte del ID de la 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 de vuelta 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 (Suite Talk se utiliza 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 en SuiteTalk y necesitas escribir en tablas con relaciones para ver las subtablas

  Nota

  Hay parámetros adicionales admitidos, si es necesario. Se explican en detalle 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 es 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á an App Builder mensaje de "Éxito" 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 App Builder. Bases de datos que están conectadas a App Builder se denominan "fuente de datos".

1. Navegue hasta la App Builder Centro de control

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 base de datos. App Builder página de almacenamiento de datos. Si ya se agregó la fuente de datos, 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 fuente 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 de visualización único

   3. Patrón de importación: esto permite a los usuarios importar solo ciertas tablas al incluirlas 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 se actualice la página, 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.

   

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

Servicios Web SuiteQL de NetSuite 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 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 ver registros y datos de NetSuite. Nuestra recomendación es utilizar SuiteQL para la lectura y la creación de objetos. App Builder por sí solo, 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 App Builder por diseño, SuiteTalk solo admitirá algunas uniones y predicados.

Después de configurarlo correctamente en App Builder suiteTalk le proporcionará una tabla de Extremos basados en Extremos SOAP en NetSuite.

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