Conector de NetSuite Eliminar en Jitterbit Design Studio

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

Esta página describe cómo eliminar registros existentes de NetSuite por ID utilizando un ejemplo simple con IDs externos proporcionados en un archivo CSV a través de Jitterbit. Esto completa la demostración utilizando registros de ejemplo creados y actualizados durante los recorridos para crear conector de NetSuite, actualizar conector de NetSuite y upsert de conector de NetSuite.

Las siguientes secciones están divididas en el inicio de la actividad de eliminació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 eliminación de NetSuite

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

   • Ve a Archivo > Nuevo > Conectores > Nueva Eliminación de NetSuite.
   • En el árbol a la izquierda bajo Conectores, haz clic derecho en la categoría NetSuite, luego selecciona Nueva Eliminació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 Eliminación de NetSuite y selecciona Nueva Eliminación de NetSuite.
   • En la barra de herramientas superior, haz clic en el ícono del conector (pieza de rompecabezas naranja) . En el popup, selecciona NetSuite, luego selecciona Eliminación de NetSuite.

2. La pantalla de Endpoint del Asistente de Eliminación de NetSuite debería abrirse en la vista principal de Studio. Esta pantalla solicita seleccionar el endpoint del cual deseas eliminar registros. Deberías haber configurado tu endpoint en endpoint del conector de NetSuite. Usa el menú desplegable para seleccionar el endpoint apropiado. Haz clic en Finalizar para completar el asistente.

   

3. Jitterbit procederá a crear una estructura de solicitud y respuesta de API de NetSuite que permitirá eliminar registros dentro de tu cuenta de NetSuite conectada. Debería aparecer una nueva pestaña en Studio llamada NetSuite GetLists. Puedes renombrar tu actividad GetList aquí si lo deseas; en el ejemplo, la nuestra se llama "Ejemplo de Eliminación de NetSuite." También puedes usar los botones + - o las flechas para expandir todos los elementos dentro de cada estructura.

   

4. 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 eliminará los datos de clientes existentes en NetSuite.

5. Se debería abrir una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica de la actividad de eliminació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.

   Guarda tu operación haciendo clic en el ícono de disco único 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 Operaciones y el título de la operación desaparecen a medida que tu nueva actividad de eliminación se crea y se guarda 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 Fuente, Solicitud, Respuesta y Destino.

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 la Respuesta y el Destino 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: 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 eliminar registros de clientes existentes por ID. Estos mismos IDs originalmente estaban mapeados al ID externo de NetSuite durante los ejemplos de crear, actualizar y upsert.

  Nota

  La eliminación en NetSuite admite la eliminación de datos de objetos por ExternalID o InternalID.

  Para este ejemplo, utilizaremos la misma fuente creada en el ejemplo de GetList del conector de NetSuite. Si has seguido este tutorial, para usar el mismo archivo CSV, haz doble clic en el ícono de Fuente y selecciona la fuente existente CustomerGetListRequest.csv.

  Si se crea desde cero, primero haz doble clic en el ícono de Fuente, luego haz clic en el botón Crear Nueva Fuente y dale a tu fuente un Nombre (por ejemplo, CustomerDeleteRequest.csv). A continuación, para este ejemplo, estamos utilizando un agente privado con archivos locales habilitados, y por lo tanto selecciona 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 'CustomerGetListRequest.csv'. También expandiremos las Opciones y estableceremos Ignorar Líneas en Primera: '1' ya que nuestro archivo CSV utiliza una fila de encabezado.

  Nota

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

• Destino: Haz doble clic en el ícono de Destino. En el ejemplo, registraremos la respuesta de NetSuite en un archivo XML. Haz clic en el botón Crear Nuevo Destino, dale a tu destino un Nombre (por ejemplo, CustomerDeleteResponse.xml), 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 'CustomerDeleteResponse.xml'.

  Nota

  También se puede exportar a una variedad de diferentes tipos de destino. El tipo no tiene que ser el mismo que el tipo de origen. Consulte Targets para ver las opciones.

• Request: Haga doble clic en el ícono de Request y seleccione Create New Transformation. Esto abrirá el Transformation Wizard que lo guiará a través de la creación de la solicitud.

  Nota

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

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

  2. En la siguiente pantalla, Source, use el menú desplegable Available File Format Definitions para seleccionar la definición existente "Example Customer Flat File ID Only" que se creó en el ejemplo de NetSuite connector GetList.

     Si se crea desde cero, use el menú desplegable Available File Format Definitions para seleccionar Create New. Esto abrirá opciones adicionales para definir un nuevo formato de archivo. Proporcione un Name para el nuevo formato de archivo (en el ejemplo llamamos al nuestro "Example Customer Flat File ID Only"). Para crear la definición de texto basada en nuestro archivo CSV existente, seleccione Create From File, luego en la ventana emergente busque el archivo local 'CustomerGetListRequest.csv'. Haga clic en Finish para continuar.

  3. La pestaña Transformations debería abrirse donde puede completar su mapeo. Use el + para expandir los elementos de origen y destino en cada árbol. Luego, arrastre y suelte cada campo que desee mapear de un árbol a otro. En este caso, el ID proporcionado en nuestro archivo CSV se mapea al campo 'externalId' en NetSuite.

     A continuación, necesitamos definir el objeto para la eliminación. Para hacer esto, haga doble clic en el campo 'type' debajo de 'externalId' e ingrese "customer" entre comillas dobles en el Formula Builder para eliminar los registros de Cliente asociados con los IDs proporcionados:

<trans>
"cliente"
</trans>

Su mapeo de transformación final debería verse similar al mostrado a continuación:

• Respuesta: Haga clic derecho en el ícono de Respuesta y seleccione Pasar a través. Esto nos permitirá pasar todos los datos asociados con los registros eliminados al archivo de salida.

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

Desplegando y ejecutando la operación

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

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

2. Luego haga 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 su operación se ejecutó con éxito. Si no, puede 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 pasó a su archivo de destino. En el ejemplo, el archivo ahora se crea en 'C:\NetSuiteSampleFiles\CustomerDeleteResponse.xml'. El archivo debería contener todos los datos sobre los registros de clientes eliminados por ID.

5. Además, cuando revises tu cuenta de NetSuite, deberías encontrar que los registros de clientes eliminados ya no existen.

   Nota

   Puedes 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 la respuesta que se envió a Jitterbit.