Lista de Obtención del Conector NetSuite¶

La actividad NetSuite GetList disponible dentro del NetSuite Connector le permite consultar registros por ID interno o externo en una instancia de NetSuite conectada usando Jitterbit.

Esta página describe cómo consultar registros de NetSuite existentes por ID usando un ejemplo simple con ID externos proporcionados en un archivo CSV a través de Jitterbit. Esto continúa la demostración utilizando registros de ejemplo creados y actualizados durante los tutoriales para NetSuite Connector Create, Actualización del conector NetSuite, y Actualización del conector NetSuite.

Las siguientes secciones se dividen en comenzar la actividad GetList, definir los componentes de la operación e desplegar y ejecutar la operación.

Crear una Operación GetList de NetSuite¶

1. Dentro de su proyecto dentro de Jitterbit Studio, hay varias maneras de comenzar una nueva actividad NetSuite GetList. Cada una de las siguientes opciones iniciará el Asistente GetList de NetSuite para guiarlo a través del proceso.

   • Vaya a Archivo > Nuevo > Conectores > Nueva GetList de NetSuite.
   • En el árbol de la izquierda, debajo de Conectores, haga clic con el botón derecho en la categoría NetSuite y luego seleccione Nueva lista de obtención de NetSuite.
   • En el árbol de la izquierda bajo Conectores, haga doble clic en la categoría NetSuite, luego haga clic derecho en Nueva NetSuite GetList y seleccione Nueva NetSuite GetList.
   • En la barra de herramientas superior, haga clic en el icono del conector (pieza de rompecabezas naranja) . En la ventana emergente, seleccione NetSuite, luego seleccione NetSuite GetList.

2. La pantalla Extremo del NetSuite GetList Wizard debería abrirse en la vista principal de Studio. Esta pantalla le solicita que seleccione el extremo del que desea obtener los datos. Ya debería haber configurado su extremo en NetSuite Connector Extremo. Utilice el menú desplegable para seleccionar el extremo apropiado. Haga clic en Siguiente cuando haya terminado.

3. La pantalla Objeto del Asistente GetList de NetSuite le pide que seleccione el objeto desde el que desea consultar los registros. En este momento, solo se puede consultar un tipo de objeto por solicitud. En este ejemplo queremos consultar registros de clientes existentes en NetSuite, por lo que seleccionamos el objeto "Cliente" y luego hacemos clic en Finalizar para continuar.

   Nota

   Si tiene muchos objetos disponibles en su cuenta NetSuite, es posible que deba esperar un momento para que se carguen. También puede ingresar un nombre de objeto en el campo Filtro o usar el menú desplegable Objetos para mostrar para limitar los resultados a "Objetos estándar" u "Objetos personalizados". Pruebe el botón Actualizar si los resultados no son los esperados.

   

4. Luego, Jitterbit procederá a crear una estructura de solicitud y respuesta de la API de NetSuite que permitirá consultar los datos dentro de su cuenta NetSuite conectada. Debería aparecer una nueva pestaña en Studio llamada NetSuite GetLists. Puede cambiar el nombre de su actividad GetList aquí si lo desea; en el ejemplo el nuestro se llama "Ejemplo de cliente GetList de NetSuite ". También puede utilizar los botones o flechas + - para expandir todos los elementos dentro de cada estructura.

5. A continuación, en la misma pantalla, haga clic en el botón Crear operación ubicado en Usar en una integración en la esquina superior derecha. Esto creará la operación Jitterbit que consultar los datos de los clientes existentes en NetSuite.

6. Debería abrirse una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica de la actividad GetList.

   Nota

   Los íconos para Fuente, Solicitud, Respuesta y Destino en la imagen de arriba son marcadores de posición para los componentes de la operación, que definiremos en la siguiente sección.

   Guarde su operación haciendo clic en el ícono de un solo disco para guardar solo esta operación o en el ícono de varios discos para guardar todos los cambios en su proyecto de integración. Debería ver que el asterisco en la pestaña Operaciones y el título de la operación desaparecen cuando su nueva actividad GetList ahora se crea y se guarda en su proyecto.

Definición de los Componentes de la Operación¶

A continuación, debemos definir los otros componentes de la operación que aparecen dentro de la representación gráfica, incluidos Fuente, Solicitud, Respuesta y Destino.

Para fines de este tutorial, proporcionamos los siguientes ejemplos como referencia arriba: Jitterpak NetSuiteExample.jpk y los archivos adjuntos en NetSuiteSampleFiles.zip. Se pueden utilizar muchos tipos diferentes de datos para cada componente de la operación. Para obtener más información sobre opciones de personalización adicionales, consulte Design Studio sección de nuestra documentación.

• Fuente: En el ejemplo, utilizamos un archivo CSV como solicitud de entrada para consultar los registros de clientes existentes por ID. Estos mismos ID se asignaron originalmente al ID externo de NetSuite durante el ejemplo NetSuite crear, actualizar, y insertar operaciones.

  Nota

  NetSuite GetList admite la consultar de datos de objetos mediante ID externo o ID interno.

  • ExternalID: Si el ID que desea utilizar para NetSuite ExternalID aún no existe en los registros existentes de NetSuite, puede realizar una Actualización del conector de NetSuite o Actualización del conector NetSuite operación para agregarlo.
  • InternalID: NetSuite InternalID es generado por NetSuite y se puede obtener del registro dentro de NetSuite. También se puede consultar desde una Búsqueda de conector NetSuite operación así como esta operación GetList.

  Para usar el archivo CSV, primero haga doble clic en el icono Fuente, luego haga clic en el botón Crear nueva fuente y asigne un Nombre a su fuente (por ejemplo, CustomerGetListRequest.csv). A continuación, para este ejemplo, estamos usando un Agente Privado con archivos locales habilitados, y así seleccionar un Tipo de "Archivo local" y luego Buscar hasta la ubicación. Si está utilizando los archivos de ejemplo, la Carpeta es 'C:\NetSuiteSampleFiles' y Obtener archivos es 'CustomerGetListRequest.csv'. También expandiremos las Opciones y estableceremos Ignorar líneas en Primero: '1' ya que nuestro archivo CSV usa una fila de encabezado.

  Nota

  Hay una variedad de tipos de fuentes disponibles en Jitterbit. Vea Fuentes para más.

• Destino: Haga doble clic en el icono Destino. En el ejemplo, registraremos la respuesta de NetSuite en un archivo XML. Haga clic en el botón Crear nuevo destino, asigne un Nombre a su destino (p. ej., CustomerGetListResponse.xml) y seleccione nuevamente un Tipo de "Archivo local" y Buscar en una ubicación. en el Agente Privado donde queremos guardar los datos. En el ejemplo, la Carpeta es 'C:\NetSuiteSampleFiles' y el Nombre de archivo es 'CustomerGetListResponse.xml'.

  Nota

  También puede generar salida a una variedad de tipos de destino diferentes. El tipo no tiene que ser el mismo que el tipo de origen. Consulte Objetivos para opciones.

• Solicitud: Haga doble clic en el icono Solicitar y seleccione Crear nueva Transformación. Esto abrirá el Asistente de Transformación que le guiará en el proceso de creación de la solicitud.

  Nota

  Se proporciona información adicional sobre las estructuras solicitadas en Transformaciones.

  1. En la primera pantalla, Nombre, proporcione un Nombre para su transformación o déjelo como predeterminado. Luego use el menú desplegable Fuente para seleccionar el tipo de fuente. Para el ejemplo utilizamos un archivo CSV, que se considera "Texto". Haga clic en Siguiente para continuar.

  2. En la siguiente pantalla, Fuente, use el menú desplegable Definiciones de formato de archivo disponibles para seleccionar Crear nuevo. Esto abrirá opciones adicionales para definir un nuevo formato de archivo. Proporcione un Nombre para el nuevo formato de archivo (en el ejemplo llamamos al nuestro "Ejemplo de ID de archivo plano del cliente únicamente"). Para crear la definición de texto basada en nuestro archivo CSV existente, seleccione Crear desde archivo, luego, en la ventana emergente, busque el archivo local 'CustomerGetListRequest.csv'. Haga clic en Finalizar para continuar.

  3. La pestaña Transformaciones debería abrirse donde podrás completar tu mapeo. Utilice + para expandir los elementos de origen y destino en cada árbol. Luego arrastre y suelte cada campo que desee asignar de un árbol a otro. En este caso, la ID proporcionada en nuestro archivo CSV se asigna al campo 'externalId' en NetSuite.

     Su mapeo de transformación debería ser similar al que se muestra a continuación:

• Respuesta: Haga clic con el botón derecho en el icono Respuesta y seleccione Pasar a través. Esto nos permitirá capturar todos los datos asociados con los registros que consultamos.

  Nota

  En este ejemplo queremos consultar datos de NetSuite y pasarlos a un archivo de salida, o nuestro archivo XML. Si quisiéramos transformar cualquiera de los datos antes de su salida, podríamos crear una nueva transformación aquí, similar a los otros ejemplos proporcionados en NetSuite crear, actualizar, insertar, y buscar operaciones.

• Secuencias de Comandos opcionales: Puede encontrar funciones de secuencia de comandos adicionales para usar durante su Transformación mapeo o por separado como Secuencias de Comandos bajo el Creador de fórmulas sección. Para obtener información adicional, consulte NetSuite Connector Avanzado.

Despliegue y Ejecución de la Operación¶

Con la actividad NetSuite GetList completamente configurada, estamos listos para desplegar y ejecutar la operación.

1. Desde la pestaña Operaciones, haga clic en desplegar icono.
2. Luego haga clic en ejecutar para colocar la operación en la cola para su ejecución.
3. En la parte inferior de la pantalla, el monitor de operación debería indicar que su operación se ejecutó exitosamente. De lo contrario, puede hacer doble clic en el icono Estado para ver los mensajes de registro.
4. Ahora también debería ver la respuesta de salida que se pasó a su archivo de destino. En el ejemplo, el archivo ahora se crea en 'C:\NetSuiteSampleFiles\CustomerGetListResponse.xml'. El archivo debe contener todos los datos de los registros de clientes consultados por ID.