Actualización del conector de NetSuite en Jitterbit Design Studio

La actividad de actualización de NetSuite disponible dentro del conector de NetSuite permite actualizar registros existentes en una instancia de NetSuite conectada utilizando Jitterbit.

Esta página describe cómo actualizar registros existentes de NetSuite utilizando un ejemplo de actualización del número de teléfono de un registro de cliente existente en NetSuite a partir de datos de origen proporcionados en un archivo CSV a través de Jitterbit.

Este ejemplo demuestra una actualización de un registro de cliente que fue creado como ejemplo durante el recorrido de creación del conector de NetSuite. Este ejemplo se utiliza solo con fines de demostración y no cubre todas las opciones disponibles en el producto; consulta Design Studio para documentación más completa.

Las siguientes secciones se dividen en el inicio de la actividad de actualización, la definición de los componentes de la operación y el despliegue y ejecución de la operación.

Creando una operación de actualización de NetSuite

1. Dentro de tu proyecto en Jitterbit Studio, hay varias formas de comenzar una nueva actividad de actualización de NetSuite. Cada una de las siguientes opciones iniciará el Asistente de Actualización de NetSuite para guiarte a través del proceso.

   • Ve a Archivo > Nuevo > Conectores > Nueva Actualización de NetSuite.
   • En el árbol a la izquierda bajo Conectores, haz clic derecho en la categoría NetSuite, luego selecciona Nueva Actualización de NetSuite.
   • En el árbol a la izquierda bajo Conectores, haz doble clic en la categoría NetSuite, luego haz clic derecho en Nueva Actualización de NetSuite y selecciona Nueva Actualización de NetSuite.
   • En la barra de herramientas superior, haz clic en el ícono del conector (pieza de rompecabezas naranja) . En la ventana emergente, selecciona NetSuite, luego selecciona Actualización de NetSuite.

2. La pantalla de Endpoint del Asistente de Actualización de NetSuite debería abrirse en la vista principal de Studio. Esta pantalla solicita seleccionar el endpoint en el que te gustaría actualizar datos existentes. Ya deberías haber configurado tu endpoint en endpoint del conector de NetSuite. Usa el menú desplegable para seleccionar el endpoint apropiado. Haz clic en Siguiente cuando termines.

   

3. La pantalla de Objeto del Asistente de Actualización de NetSuite te pide que selecciones el objeto en el que te gustaría actualizar datos existentes. En este ejemplo, queremos actualizar un registro de cliente existente en NetSuite, así que seleccionamos el objeto "Cliente", luego hacemos clic en Finalizar para continuar.

   Nota

   Si tienes muchos objetos disponibles en tu cuenta de NetSuite, es posible que debas esperar un momento para que se carguen. También puedes ingresar un nombre de objeto en el campo Filtro o usar el menú desplegable Objetos a mostrar para limitar los resultados a "Objetos Estándar" u "Objetos Personalizados". Prueba el botón Actualizar si los resultados no son lo que esperabas.

   

4. Jitterbit procederá a crear una estructura de solicitud y respuesta de API de NetSuite que permitirá actualizar los datos existentes en su cuenta de NetSuite conectada. Debería aparecer una nueva pestaña en Studio llamada Actualizaciones de NetSuite. Puede renombrar su actividad de actualización aquí si lo desea; en el ejemplo, la nuestra se llama "Ejemplo de Actualización de Cliente de NetSuite." También puede usar los botones + - o las 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 bajo Usar en una Integración en la esquina superior derecha. Esto creará la operación de Jitterbit que actualizará los datos de 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 de actualización.

   

   Nota

   Los íconos de Fuente, Solicitud, Respuesta y Destino en la imagen anterior 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 disco simple para guardar solo esta operación o en el ícono de disco múltiple para guardar todos los cambios en su proyecto de integración. Debería ver el asterisco en la pestaña Operaciones y el título de la operación desaparecer a medida que su nueva actividad de actualización se crea y guarda en su proyecto.

Definiendo los componentes de la operación

A continuación, necesitamos definir los otros componentes de la operación que aparecen dentro de la representación gráfica, incluyendo 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 ícono para configurar cada componente. Como alternativa, también podría crear la Fuente, Solicitud, Respuesta y Destino por separado y luego arrastrarlos y soltarlos desde el árbol a la izquierda directamente sobre los íconos en la representación visual de su operación.

Para los propósitos de este recorrido, proporcionamos los siguientes ejemplos para referencia arriba: Jitterpak NetSuiteExample.jpk y archivos acompañantes en NetSuiteSampleFiles.zip. Se pueden utilizar muchos tipos diferentes de datos para cada componente de la operación. Para aprender más sobre opciones de personalización adicionales, consulta la sección Design Studio de nuestra documentación.

• Fuente: En el ejemplo, utilizamos un archivo CSV como la solicitud de entrada para actualizar el cliente existente con los valores de campo proporcionados a continuación. La siguiente tabla muestra el contenido del archivo de ejemplo CustomerUpdateRequest.csv.

  ID	Nombre	Correo electrónico	Teléfono	Dirección	Ciudad	Estado	Código Postal
  Test Cust 1	Test Customer 1	test1@example.com	1-999-999-9999	1234 Main St.	Denver	CO	80250

  Nota

  Una actualización de NetSuite debe incluir siempre (1) un campo ID que mapee al ExternalID del cliente en NetSuite, o (2) el InternalID del registro del cliente en NetSuite. Este ejemplo utiliza el ExternalID creado durante NetSuite connector create. Sin embargo, si deseas utilizar un InternalID, puedes encontrarlo dentro de NetSuite o dentro de Jitterbit a través de una NetSuite connector search.

  Nota

  El cliente existente fue creado originalmente con un número de teléfono de 1-111-111-1111 en el ejemplo utilizado para NetSuite connector create. En el archivo fuente para la operación de actualización, incluimos el número de teléfono cambiado junto con los otros campos originales porque estamos utilizando la misma definición de formato de archivo. Sin embargo, podrías omitir los otros campos si deseas crear un nuevo formato de archivo solo con esos campos.

  Nota

  Hay una variedad de tipos de origen disponibles en Jitterbit. Consulta Fuentes para más información.

  Para usar el archivo CSV, primero haz doble clic en el ícono de Origen, luego haz clic en el botón Crear Nuevo Origen y dale un Nombre a tu origen (por ejemplo, CustomerUpdateRequest.csv). A continuación, para este ejemplo, estamos utilizando un agente privado con archivos locales habilitados, y por lo tanto seleccionamos un Tipo de "Archivo Local" y luego Examinar para la ubicación. Si estás utilizando los archivos de ejemplo, la Carpeta es 'C:\NetSuiteSampleFiles' y el Obtener Archivos es 'CustomerUpdateRequest.csv'. También expandiremos las Opciones y configuraremos Ignorar Líneas a Primera: '1' ya que nuestro archivo CSV utiliza una fila de encabezado.

• Destino: Haz doble clic en el ícono de Destino. En el ejemplo, registraremos la respuesta de NetSuite en un archivo CSV para proporcionar información sobre el éxito/fallo. Haz clic en el botón Crear Nuevo Destino, dale un Nombre a tu destino (por ejemplo, CustomerUpdateResponse.csv), y nuevamente selecciona un Tipo de "Archivo Local" y Examinar para una ubicación en el agente privado donde queremos guardar los datos. En el ejemplo, la Carpeta es 'C:\NetSuiteSampleFiles' y el Nombre del Archivo es 'CustomerUpdateResponse.csv'.

  Nota

  También puedes enviar la salida a una variedad de diferentes tipos de destino. El tipo no tiene que ser el mismo que el tipo de origen. Consulta Destinos para opciones.

• Solicitud: Haz doble clic en el ícono de Solicitud y selecciona Crear Nueva Transformación. Esto abrirá el Asistente de Transformación que te guiará a través de la creación de la solicitud.

  Nota

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

  1. En la primera pantalla, Nombre, proporciona un Nombre para tu transformación o déjalo como el predeterminado. Luego utiliza el menú desplegable de Origen para seleccionar el tipo de origen. Para el ejemplo, utilizamos un archivo CSV, que se considera "Texto." Haz clic en Siguiente para continuar.

  2. En la siguiente pantalla, Source, utiliza el menú desplegable Available File Format Definitions para seleccionar la misma definición de formato de archivo de origen creada durante NetSuite connector create (es decir, "Ejemplo de archivo plano de cliente").

     O, si estás creando desde cero, puedes seleccionar Create New. Esto abrirá opciones adicionales para definir un nuevo formato de archivo. Proporciona un Name para el nuevo formato de archivo (en el ejemplo lo llamamos "Ejemplo de archivo plano de cliente"). Para crear la definición de texto basada en nuestro archivo CSV existente, selecciona Create From File, luego en la ventana emergente busca el archivo local 'CustomerUpdateRequest.csv'.

     Haz clic en Finish para continuar.

  3. La pestaña Transformations debería abrirse donde puedes completar tu mapeo. Usa el + para expandir los elementos de origen y destino en cada árbol. Luego arrastra y suelta cada campo que te gustaría mapear de un árbol al otro.

     Nota

     Una actualización de NetSuite debe incluir siempre (1) un campo ID que se mapea al ExternalID del cliente en NetSuite, o (2) el InternalID del registro del cliente en NetSuite. Este ejemplo utiliza el ExternalID creado durante el ejemplo de NetSuite connector create. Si estuvieras utilizando InternalID, en su lugar mapearías al campo internalId de NetSuite.

     Tu mapeo de transformación debería verse similar al que se muestra a continuación:

     

• Response: Haz doble clic en el ícono de Response y selecciona Create New Transformation. Esto abrirá el Transformation Wizard que te guiará a través de la creación de la respuesta.

  Nota

  Se proporciona información adicional sobre las estructuras de respuesta en Transformations.

  1. En la primera pantalla, Name, proporciona un Name para tu transformación o déjalo como el predeterminado. Luego utiliza el menú desplegable Target para seleccionar el tipo de destino. Para el ejemplo utilizamos un archivo CSV, que se considera "Texto." Haz clic en Next para continuar.

  2. En la siguiente pantalla, Target, utiliza el menú desplegable Available File Format Definitions para seleccionar la misma definición de formato de archivo de destino creada durante NetSuite connector create (es decir, "Estructura de Respuesta de NetSuite").

     O, si estás creando desde cero, puedes seleccionar Create New. En el ejemplo configuramos una estructura de respuesta típica que escribirá el ID externo, el estado y el mensaje en la respuesta para que recibamos retroalimentación si la operación de actualización falla. En la primera pantalla, establece el Name del nuevo formato de archivo (en el ejemplo, el nuestro se llama "Estructura de Respuesta de NetSuite"), luego haz clic en el botón para Create Manually. En la siguiente pantalla, haz clic en New y agrega tres nuevos campos llamados "ExternalID," "Status," y "Message."

     Haz clic en Finish para continuar.

  3. La pestaña Transformations debería abrirse donde puedes completar tu mapeo. Usa el + para expandir los lados de origen y destino. En este ejemplo, agregaremos scripts para obtener el ID externo en NetSuite para que si la operación falla, ahora sepamos el ID del registro fallido para solucionar problemas. Para hacer esto:

     • Arrastra y suelta el campo "isSuccess" desde el lado de origen al nuevo campo "Status" en el lado de destino.

     • Haz doble clic en el campo "ExternalID" en el lado de destino para abrir el Formula Builder y agrega las siguientes funciones al script, luego haz clic en OK.

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

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

     • Haz doble clic en el campo "Message" en el lado de destino para abrir el Formula Builder y agrega las siguientes funciones al script, luego haz clic en OK.

       <trans>
       SumString(jbroot$jbresponse$updateListResponse$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

       Encuentra funciones de script adicionales para usar durante tu mapeo de Transformación o por separado como Scripts en la sección de Constructor de fórmulas. Además, hay varias funciones específicas de NetSuite documentadas en Funciones de conector que se pueden usar para mapeos o scripts más complejos.

     Tu mapeo de transformación debería verse similar al que se muestra a continuación:

     

• Scripts opcionales: Puedes encontrar funciones de script adicionales para usar durante tu mapeo de Transformación o por separado como Scripts en la sección de Constructor de fórmulas. Para información adicional, consulta Conector de NetSuite avanzado.

Desplegando y ejecutando la operación

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

1. Desde la pestaña Operaciones, haz clic en el ícono de desplegar .

2. Luego haz clic en el ícono de ejecutar para colocar la operación en la cola para su ejecución.

3. En la parte inferior de la pantalla, el Monitor de operaciones debería indicar que tu operación se ejecutó con éxito. Si no, puedes hacer doble clic en el ícono de Estado para ver cualquier mensaje de registro.

   

4. También debería ver ahora la respuesta de salida que se mapeó a su archivo de destino. En el ejemplo, el archivo ahora se crea en 'C:\NetSuiteSampleFiles\CustomerUpdateResponse.csv'. Dado que la operación se ejecutó con éxito, vemos el campo ID seguido de un estado de '1', indicando éxito. Si la operación falló, veríamos un '0' junto con una tercera columna que muestra el mensaje de error del registro.

   ExternalID	Status	Message
   Test Cust 1	1

5. Además, cuando revise su cuenta de NetSuite, debería encontrar la información del cliente actualizada con el nuevo número de teléfono.

   

   Nota

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