Conector de NetSuite Crear en Jitterbit Design Studio
La actividad de creación de NetSuite disponible dentro del conector de NetSuite permite crear nuevos registros en una instancia de NetSuite conectada utilizando Jitterbit.
Nota
Antes de configurar una operación de creación de NetSuite, necesitarás tener un endpoint de NetSuite definido. Para más información sobre cómo crear un endpoint, consulta endpoint del conector de NetSuite.
Esta página describe cómo crear nuevos registros de NetSuite utilizando un ejemplo de creación de nuevos registros de clientes en NetSuite a partir de datos de origen proporcionados en un archivo CSV a través de Jitterbit.
Ejemplo
Para referencia, consulta el Jitterpak NetSuiteExample.jpk y los archivos acompañantes en NetSuiteSampleFiles.zip. Descomprime el NetSuiteSampleFiles.zip en tu unidad "C:\" o, si lo descomprimes en otro directorio, asegúrate de editar los directorios de origen y destino en las operaciones. Si es tu primera vez utilizando un Jitterpak, consulta Importando un Jitterpak.
Este ejemplo se utiliza solo con fines de demostración y no cubre todas las opciones disponibles en el producto; consulta Design Studio para una documentación más completa.
Las siguientes secciones se dividen en el inicio de la actividad de creació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 creación de NetSuite
Nota
Si no estás familiarizado con Jitterbit, consulta Comenzar o Design Studio para información detallada sobre cómo utilizar el producto.
-
Dentro de tu proyecto en Jitterbit Studio, hay varias formas de comenzar una nueva actividad de creación de NetSuite. Cada una de las siguientes opciones iniciará el Asistente de Creación de NetSuite para guiarte a través del proceso.
- Ve a Archivo > Nuevo > Conectores > Nueva Creación de NetSuite.
- En el árbol a la izquierda bajo Conectores, haz clic derecho en la categoría NetSuite, luego selecciona Nueva Creació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 Creación de NetSuite y selecciona Nueva Creació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 Crear NetSuite.
-
La pantalla de Endpoint del Asistente de Creación de NetSuite debería abrirse en la vista principal de Studio. Esta pantalla solicita seleccionar el endpoint en el que se desea crear nuevos datos. Ya deberías haber configurado tu endpoint en el endpoint del conector de NetSuite. Utiliza el menú desplegable para seleccionar el endpoint apropiado. Haz clic en Siguiente cuando termines.
-
La pantalla de Objeto del Asistente de Creación de NetSuite te pide seleccionar el objeto en el que deseas crear nuevos datos. En este ejemplo, queremos crear un nuevo registro de cliente 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" o "Objetos Personalizados". Prueba el botón Actualizar si los resultados no son lo que esperabas.
-
Jitterbit procederá a crear una estructura de solicitud y respuesta de API de NetSuite que permitirá crear datos dentro de tu cuenta de NetSuite conectada. Debería aparecer una nueva pestaña en Studio llamada NetSuite Creates. Puedes renombrar tu actividad de creación aquí si lo deseas; en el ejemplo, la nuestra se llama "Ejemplo de Creación de Cliente en NetSuite." También puedes usar los botones + - o las flechas para expandir todos los elementos dentro de cada estructura.
-
A continuación, en la misma pantalla, haz 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 generará nuevos datos de cliente en NetSuite.
-
Debería abrirse una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica de la actividad de creación.
Nota
Los íconos para Source, Request, Response y Target en la imagen anterior son marcadores de posición para los componentes de la operación, que definiremos en la siguiente sección.
Guarda tu operación haciendo clic en el ícono de disco simple para guardar solo esta operación o en el ícono de discos múltiples para guardar todos los cambios en tu proyecto de integración. Deberías ver que el asterisco en la pestaña Operations y el título de la operación desaparecen, ya que tu nueva actividad de creación ha sido creada y guardada en tu 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 Source, Request, Response y Target.
Para cada uno, las instrucciones a continuación te dirigen a regresar a la representación gráfica de la operación que has creado y hacer doble clic en cada ícono para configurar cada componente. Como alternativa, también podrías crear el Source, Request, Response y Target por separado y luego arrastrarlos y soltarlos desde el árbol a la izquierda directamente sobre los íconos en la representación visual de tu operación.
Para los propósitos de esta guía, 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.
-
Source: En el ejemplo, utilizamos un archivo CSV como la solicitud de entrada para crear un nuevo cliente con los valores de campo proporcionados a continuación. La siguiente tabla muestra el contenido del archivo de ejemplo CustomerCreateRequest.csv.
ID Name Email Phone Address City State Zip Test Cust 1 Test Customer 1 test1@example.com 1-111-111-1111 1234 Main St. Denver CO 80250 Test Cust 2 Test Customer 2 test2@example.com 1-222-222-2222 1234 Sample Dr. San Francisco CA 94101 Nota
Hay una variedad de tipos de fuente disponibles en Jitterbit. Consulta Fuentes para más información.
Para usar el archivo CSV, primero haz doble clic en el ícono de Fuente, luego haz clic en el botón Crear Nueva Fuente y dale un Nombre a tu fuente (por ejemplo, CustomerCreateRequest.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 'CustomerCreateRequest.csv'. También expandiremos las Opciones y estableceremos Ignorar Líneas en 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, CustomerCreateResponse.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 'CustomerCreateResponse.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 fuente. Consulta Destinos para ver las 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.
-
En la primera pantalla, Nombre, proporciona un Nombre para tu transformación o déjalo como el predeterminado. Luego utiliza el menú desplegable de Fuente para seleccionar el tipo de fuente. Para el ejemplo, utilizamos un archivo CSV, que se considera "Texto." Haz clic en Siguiente para continuar.
-
En la siguiente pantalla, Source, utiliza el menú desplegable Available File Format Definitions para 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 "Example Customer Flat File"). 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 'CustomerCreateRequest.csv'. Haz clic en Finish para continuar.
-
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
Se recomienda mapear un campo ID al campo 'externalId' del cliente en NetSuite. Esto hará que los upserts sean posibles si deseas configurarlos más adelante. Consulta NetSuite connector upsert para más detalles.
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.
-
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 "Text." Haz clic en Next para continuar.
-
En la siguiente pantalla, Target, utiliza el menú desplegable Available File Format Definitions para seleccionar Create New. En el ejemplo configuraremos 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 creación falla. En la primera pantalla, establece el Name del nuevo archivo (en el ejemplo el nuestro se llama "NetSuite Response Structure"), 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.
-
La pestaña de Transformaciones 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, de modo que si la operación falla, ahora conozcamos 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 Constructor de Fórmulas y agrega las siguientes funciones al script, luego haz clic en OK.
<trans> FindByPos(SourceInstanceCount(),jbroot$jbrequest$addList$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 Constructor de Fórmulas y agrega las siguientes funciones al script, luego haz clic en OK.
<trans> SumString(jbroot$jbresponse$addListResponse$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.
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 del Constructor de fórmulas. Para información adicional, consulta conector de NetSuite avanzado.
Desplegando y ejecutando la operación
Con la actividad de creación de NetSuite completamente configurada, estamos listos para desplegar y ejecutar la operación.
-
Desde la pestaña Operaciones, haz clic en el icono de desplegar
.
-
Luego haz clic en el icono de ejecutar
para colocar la operación en la cola para ejecución.
-
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 icono de Estado para ver cualquier mensaje de registro.
-
También deberías ver ahora la respuesta de salida que se mapeó a tu archivo de destino. En el ejemplo, el archivo ahora se crea en 'C:\NetSuiteSampleFiles\CustomerCreateResponse.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 Estado Mensaje Test Cust 1 1 Test Cust 2 1 -
Además, cuando revises tu cuenta de NetSuite, deberías encontrar los nuevos clientes creados.
Nota
Puedes encontrar más información sobre la llamada a la API de NetSuite dentro del 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.