Actualización del Conector NetSuite¶

La actividad de inserción de NetSuite disponible dentro del NetSuite Connector le permite actualizar registros existentes o crear nuevos registros en una instancia de NetSuite conectada usando Jitterbit. Una "inserción" es esencialmente una operación de actualización o creación, o ambas, según los datos proporcionados.

Esta página describe cómo actualizar registros NetSuite existentes y crear nuevos al mismo tiempo, usando un ejemplo de actualización del número de teléfono de un cliente existente y creación de un nuevo cliente en NetSuite a partir de datos de origen proporcionados en un archivo CSV a través de Jitterbit.

Este ejemplo demuestra la creación de un nuevo cliente y la actualización de la información del cliente en un registro que se creó como ejemplo durante la Creación del conector NetSuite tutorial. Este ejemplo se utiliza únicamente con fines de demostración y no cubre todas las opciones disponibles en el producto; consulte Design Studio para obtener documentación más completa.

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

Crear una Operación Upsert de NetSuite¶

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

   • Vaya a Archivo > Nuevo > Conectores > Nueva actualización de NetSuite.
   • En el árbol de la izquierda, debajo de Conectores, haga clic derecho en la categoría NetSuite y luego seleccione Nueva actualizació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 actualización de NetSuite y seleccione Nueva actualización de NetSuite.
   • 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 Upsert.

2. La pantalla Extremo del NetSuite Upsert Wizard debería abrirse en la vista principal de Studio. Esta pantalla le solicita que seleccione el extremo en el que desea crear nuevos datos o actualizar los datos existentes. 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 de inserción de NetSuite le pide que seleccione el objeto en el que desea insertar datos. En este ejemplo queremos crear un nuevo registro de cliente y actualizar un registro de cliente existente. en Netsuite, 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 API de NetSuite que permitirá insertar datos dentro de su cuenta NetSuite conectada. Debería aparecer una nueva pestaña en Studio llamada NetSuite Upserts. Puede cambiar el nombre de su actividad de inserción aquí si lo desea; en el ejemplo, el nuestro se llama "Ejemplo de cliente Upsert 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 insertará los datos del cliente en NetSuite.

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

   

   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 a medida que su nueva actividad de inserción 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 cada uno, las instrucciones a continuación le indican que regrese a la representación gráfica de la operación que ha creado y haga doble clic en cada icono para configurar cada componente. Como alternativa, también puedes crear Fuente, Solicitud, Respuesta y Destino por separado y luego arrastrarlos y soltarlos desde el árbol de la izquierda directamente en los íconos. en la representación visual de su operación.

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 actualizar un cliente existente y crear un cliente nuevo con los valores de campo proporcionados a continuación. La siguiente tabla muestra el contenido del archivo de ejemplo CustomerUpsertRequest.csv.

  identificación	Nombre	Correo	Teléfono	Dirección	Ciudad	Estado	Cremallera
  Cliente de prueba 1	Cliente de prueba 1	prueba1@ejemplo.com	1-999-999-9999	1234 calle principal	Denver	CO	80250
  Cliente de prueba 2	Cliente de prueba 2	prueba2@ejemplo.com	1-888-888-8888	1234 Muestra Dr.	San Francisco	CA	94101
  Cliente de prueba 3	Cliente de prueba 3	prueba3@ejemplo.com	1-777-777-7777	1234 Camino de ejemplo	Houston	Texas	77001

  Nota

  Un upsert de NetSuite debe incluir un campo de ID que se asigne al ID externo del cliente en NetSuite. Si es necesario crear nuevos registros, usar solo InternalID no será suficiente ya que este campo aún no se creará para nuevos registros en NetSuite.

  Nota

  En la tabla anterior, el Cliente de prueba 1 y el Cliente de prueba 2 se crearon originalmente en NetSuite Connector Create tutorial. El número de teléfono del cliente de prueba 1 se actualizó durante la Actualización del conector NetSuite tutorial. El ejemplo de un upsert en esta página incluye (1) el número de teléfono actualizado del Cliente de prueba 1, por lo que este registro se actualizará si aún no lo estaba; de lo contrario, permanecerá igual, (2) un número de teléfono recientemente actualizado para el Cliente de prueba 2 y (3) un nuevo registro de cliente para agregar el Cliente de prueba 3.

  Nota

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

  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, CustomerUpsertRequest.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 'CustomerUpsertRequest.csv'. También expandiremos las Opciones y estableceremos Ignorar líneas en Primero: '1' ya que nuestro archivo CSV usa una fila de encabezado.

• Destino: haga doble clic en el icono Objetivo. En el ejemplo, registraremos la respuesta de NetSuite en un archivo CSV para proporcionar información sobre el éxito o el fracaso. Haga clic en el botón Crear nuevo destino, asigne un Nombre a su destino (p. ej. CustomerUpsertResponse.csv) 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 'CustomerUpsertResponse.csv'.

  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, utilice el menú desplegable Definiciones de formato de archivo disponibles para seleccionar la misma definición de formato de archivo de origen creada durante Creación de NetSuite Connector (es decir, "Archivo plano de cliente de ejemplo").

     O, si está creando desde cero, puede 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 "Archivo plano de cliente de ejemplo"). 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 'CustomerUpsertRequest.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.

     Nota

     Un upsert de NetSuite debe incluir un campo de ID que se asigne al ID externo del cliente en NetSuite. Si es necesario crear nuevos registros, usar solo InternalID no será suficiente ya que este campo aún no se creará para nuevos registros en NetSuite.

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

     

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

  Nota

  Se proporciona información adicional sobre las estructuras de respuesta 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 Objetivo para seleccionar el tipo de destino. Para el ejemplo utilizamos un archivo CSV, que se considera "Texto". Haga clic en Siguiente para continuar.

  2. En la siguiente pantalla, Destino, utilice el menú desplegable Definiciones de formato de archivo disponibles para seleccionar la misma definición de formato de archivo de destino creada durante Creación de NetSuite Connector (es decir, "Estructura de respuesta de NetSuite ").

     O, si está creando desde cero, puede seleccionar Crear nuevo. En el ejemplo, configuramos una estructura de respuesta típica que escribirá el ID externo, el estado y el mensaje en la respuesta para recibir comentarios si falla la operación de inserción. En la primera pantalla, establezca el Nombre del nuevo formato de archivo (en el ejemplo, el nuestro se llama "Estructura de respuesta NetSuite "), luego haga clic en el botón para Crear manualmente. En la siguiente pantalla, haga clic en Nuevo y agregue tres campos nuevos llamados "ID externo", "Estado" y "Mensaje".

     Haga clic en Finalizar para continuar.

  3. La pestaña Transformaciones debería abrirse donde podrás completar tu mapeo. Utilice el + para expandir los lados de origen y destino. En este ejemplo, agregaremos secuencias de comandos para obtener la ID externa en NetSuite, de modo que si la operación falla, ahora sepamos la ID del registro fallido que debemos identificar y solucionar problemas. Para hacer esto:

     • Arrastre y suelte el campo "isSuccess" desde el lado de origen al nuevo campo "Estado" en el lado de destino.

     • Haga doble clic en el campo "ExternalID" en el lado de destino para abrir Formula Builder y agregue las siguientes funciones al secuencia de comandos, luego haga clic en Aceptar.

       <trans>
       FindByPos(SourceInstanceCount(),jbroot$jbrequest$upsertList$record#.Customer$externalId)
       </trans>
       

       La función FindByPos encuentra la instancia en los datos de la solicitud que corresponde a la respuesta.

     • Haga doble clic en el campo "Mensaje" en el lado de destino para abrir el Creador de fórmulas y agregue las siguientes funciones al secuencia de comandos, luego haga clic en Aceptar.

       <trans>
       SumString(jbroot$jbresponse$upsertListResponse$writeResponseList$writeResponse.status$statusDetail#.message$,"|",true)
       </trans>
       

       La función SumString concatenará un elemento que puede tener más de una instancia en una sola cadena.

       Nota

       Encuentre 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. Además, hay varias funciones específicas de NetSuite documentadas en Funciones del conector que se puede utilizar para secuencias de comandos o mapeos más complejos.

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

     

• 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 upsert de NetSuite 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 asignó a su archivo de destino. En el ejemplo, el archivo ahora se crea en 'C:\NetSuiteSampleFiles\CustomerUpsertResponse.csv'. Dado que la operación se ejecutó correctamente, vemos el campo ID seguido del estado '1', lo que indica el éxito. Si la operación falla, veríamos un '0' junto con una tercera columna que muestra el mensaje de error del registro.

   ID externo	Estado	Mensaje
   Cliente de prueba 1	1
   Cliente de prueba 2	1
   Cliente de prueba 3	1

5. Además, cuando revise su cuenta NetSuite, debería encontrar la información del Cliente de prueba 2 actualizada con el nuevo número de teléfono y el registro del Cliente de prueba 3 creado.

   

   Nota

   Puede encontrar más información sobre la llamada API a NetSuite en el Registro de uso de servicios web disponible en NetSuite en Configuración > Integración > Web Registro de uso de servicios. Esto proporciona información detallada sobre el éxito/fracaso, así como la solicitud y respuesta que se envió a Jitterbit.