Saltar al contenido

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

Descripción general

Esta guía describe los requisitos del sistema y proporciona instrucciones para conectar App Builder a un servidor de base de datos en la nube de Oracle NetSuite.

Requisitos del sistema

Estas son las versiones mínimas de navegador necesarias:

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

  • Internet Explorer: 11+

Instrucciones de conexión

Para conectar App Builder con NetSuite, debes configurar una integración en NetSuite y obtener tokens de ella, que utilizarás para establecer la conexión. Las siguientes secciones describen cómo hacer cada una de esas cosas.

Configurar una nueva integración de NetSuite

Sigue estos pasos para crear una nueva integración en NetSuite con la que App Builder pueda conectarse. Necesitarás acceso administrativo a NetSuite.

  1. Inicia sesión en NetSuite como administrador.

    attachment

  2. Navega a Configuración > Integración > Administrar Integración > Nueva.

    attachment

  3. Ingresa la información requerida y haz clic en el botón Guardar. Cuando la integración esté configurada, NetSuite generará un ID de Cliente y un Secreto únicos. Toma nota de estos valores. Los utilizarás para configurar la conexión de App Builder.

    Importante

    El ID de Cliente y el Secreto solo se muestran una vez. Asegúrate de copiar sus valores antes de continuar.

Generar tokens de acceso

Después de haber configurado la integración de NetSuite, debes generar tokens de acceso para permitir que App Builder se conecte a ella.

Sigue los pasos en la documentación de NetSuite para generar tokens. Necesitarás tanto el ID de Token como el Secreto de Token.

Agregar un servidor de datos

Ahora que has configurado una integración de NetSuite y obtenido sus tokens de acceso, estás listo para conectar App Builder a ella. Abre App Builder y sigue estos pasos:

  1. Selecciona IDE > Servidores de Datos.

  2. Haz clic en el botón + Servidor.

  3. Se muestran los siguientes campos:

    1. En la sección Configuración del Servidor:

      1. Nombre del Servidor: Ingresa un nombre para este servidor.

      2. Tipo: Haz clic para abrir el menú, luego busca y selecciona NetSuite.

      3. Nombre de la Instancia: Ingresa el ID contenido en tu URL única de NetSuite. Por ejemplo, si tu URL es https://1234567.app.netsuite.com/, entonces tu nombre de instancia es 1234567.

    2. En la sección Configuración de Seguridad:

      1. Proveedor de Seguridad: (Opcional) Selecciona un proveedor de seguridad del menú.

    3. En la sección Pruebas:

      1. Probar Conexión: Haz clic para verificar tus credenciales de conexión. Ten en cuenta que la prueba fallará si aún no has completado la Configuración Avanzada a continuación. Completa la configuración primero, luego regresa a este diálogo y prueba la conexión.

      2. Permitir Desafío: Selecciona esta casilla para permitir que App Builder redirija el navegador cuando reciba un desafío de OAuth.

  4. Haz clic en el botón Guardar.

  5. Haz clic en el botón Configuración Avanzada en la sección Configuración del Servidor. Se abre el diálogo Servidor (Configuración Avanzada).

  6. Haz clic en el botón Editar. Se muestran los siguientes campos:

    1. Avanzado: En este campo, ingresa la siguiente información:

      Schema={{ Schema }};
OAuthClientId={{ OauthClientID }};
OAuthClientSecret={{ OauthClientSecret }};
OAuthAccessToken={{ AccessToken }};
OAuthAccessTokenSecret={{ AccessSecret }};
IncludeChildTables=true;

      Realiza las siguientes sustituciones:

      1. Reemplaza Schema con SuiteQL o SuiteTalk. Consulta SuiteQL y SuiteTalk para obtener ayuda sobre cuál elegir.

      2. Reemplaza OauthClientID con el ID de Cliente que anotaste durante la configuración de la integración (consulta Configurar una nueva integración de NetSuite).

      3. Reemplaza OauthClientSecret con el Secreto que anotaste durante la configuración de la integración (consulta Configurar una nueva integración de NetSuite).

      4. Reemplaza AccessToken con el ID de Token que generaste anteriormente (ver Generar tokens de acceso).

      5. Reemplaza AccessSecret con el Secreto de Token que generaste anteriormente (ver Generar tokens de acceso).

      6. El parámetro IncludeChildTables solo es necesario si has seleccionado SuiteTalk como tu esquema y necesitas escribir en tablas con relaciones para ver las subtablas.

      Nota

      Se admiten otros parámetros, si los necesitas. Consulta la documentación de NetSuite para obtener más información.

    2. Tiempo de espera de ping: La cantidad de tiempo (en segundos) que App Builder esperará por un ping de vuelta del servidor antes de que se agote el tiempo. El valor predeterminado es 10.

    3. Escapar el nombre del parámetro de consulta: Selecciona para usar parámetros con valores de nombre reservados. Esta casilla está habilitada por defecto.

  7. Haz clic en Guardar para confirmar y guardar todas tus configuraciones.

Agregar una fuente de datos

Después de que el servidor ha sido agregado, necesita ser añadido en App Builder como una fuente de datos. Para hacer esto, sigue estos pasos:

  1. Navega a IDE > Servidores de Datos.

  2. En la tabla de Servidores de Datos, localiza el servidor que has agregado (ver Agregar un servidor de datos arriba) y selecciona su fila. El panel de Fuentes de Datos a la derecha mostrará la nueva fuente de datos, que se habrá agregado automáticamente. Haz clic en Detalles.

    Nota

    Hacer clic en el botón Detalles en la fila del servidor en la tabla de Servidores de Datos no muestra las mismas opciones.

  3. La sección superior tendrá el nombre que escribiste bajo Nombre del Servidor cuando agregaste el servidor. Haz clic en el botón Editar si deseas alterar el Nombre de la Fuente de Datos, y tener un nombre de visualización único. (Por defecto, tiene el mismo nombre que el servidor.)

  4. En la sección de Capa de Almacenamiento de Datos, haz clic en Importar. Se abrirá el cuadro de diálogo Importar Esquema.

  5. En el campo Importar Desde Patrón, ingresa el subconjunto de tablas que deseas importar de la base de datos utilizando la sintaxis mvSQL. Si este campo se deja en blanco, se importarán todas las tablas.

  6. Haga clic en Importar, luego en Continuar. La importación se programará para ejecutarse en segundo plano. Una vez que reciba un mensaje de confirmación exitoso, las tablas importadas se mostrarán a continuación.

NetSuite SuiteQL vs. SuiteTalk Web Services

Cuando agrega NetSuite como un servidor de datos en App Builder, necesita elegir si usar SuiteQL o SuiteTalk Web Services como su esquema. La información a continuación puede ayudarle a determinar cuál se adapta mejor a sus necesidades.

SuiteQL es un lenguaje de consulta basado en el lenguaje de consulta de bases 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 puede manejar consultas mucho más complicadas que SuiteTalk. Por ejemplo, uniones, agregaciones, agrupaciones, ordenamientos y fórmulas pueden ser manejados del lado del servidor utilizando SuiteQL. Dentro de App Builder, SuiteQL le permitirá mostrar Objetos como Vistas.

attachment

SuiteTalk Web Services es un servicio web basado en SOAP utilizado para la integración con sistemas externos, en este caso App Builder. Por diseño, SuiteTalk solo admitirá algunas uniones y predicados. SuiteTalk le proporcionará puntos finales de tabla basados en puntos finales SOAP en NetSuite.

attachment

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 manejar SQL. Nuestra recomendación es usar SuiteQL para lectura y construcción de objetos y SuiteTalk para escribir y actualizar datos.

Limitaciones

  • NetSuite limita la concurrencia de consultas que se ejecutan contra él por conexión y licencias por grupo de conexiones, lo que impacta el rendimiento de lectura.

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

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

Solución de problemas

Si experimenta problemas con el servidor de Oracle NetSuite, se recomiendan los siguientes pasos de solución de problemas:

  1. Habilite el registro de datos para generar archivos de registro y datos, que puede descargar e inspeccionar.

  2. Consulte la documentación del proveedor CData ADO.NET para NetSuite para obtener información detallada.