Conector Four51 Crear en Jitterbit Design Studio

La actividad de creación de Four51 disponible dentro del conector Four51 permite crear nuevos datos en Four51 a través de la API de OrderCloud utilizando Jitterbit.

Esta página describe cómo crear nuevos datos en Four51 utilizando un ejemplo de creación de una nueva dirección de comprador usando Jitterbit.

Las siguientes secciones están divididas 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 Four51

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

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

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

   

3. Las siguientes pantallas en el Asistente de Creación de Four51 te ayudan a profundizar en el objeto específico en el que deseas crear datos. La primera de estas pantallas, Sección, te pide que selecciones una de las categorías de nivel superior listadas dentro de Four51: "Autenticación", "Comprador", "Pedido", "Organización" o "Perspectiva del Usuario".

   Nota

   Puedes averiguar qué selecciones hacer consultando la API de OrderCloud. Por ejemplo, estas cinco categorías de nivel superior corresponden directamente con las que se enumeran en el lado izquierdo de la Consola de API de OrderCloud. Las pantallas de selección de objetos restantes también siguen la organización de la API de OrderCloud.

   En el ejemplo, queremos crear una nueva dirección de comprador, así que seleccionamos la sección "Comprador" y hacemos clic en Siguiente para continuar.

   

4. La siguiente pantalla en el Asistente de Creación de Four51, llamada Recurso, muestra los recursos disponibles dentro de la sección seleccionada. En el ejemplo, dado que queremos crear una nueva dirección, seleccionamos "Direcciones" y hacemos clic en Siguiente para continuar.

   

5. La pantalla de selección final en el Asistente de Creación de Four51, llamada Endpoint de Recurso, muestra los objetos finales disponibles para el recurso seleccionado. En el ejemplo, para crear una nueva dirección, seleccionamos la opción "Crear Nueva Dirección". Haz clic en Finalizar para continuar.

   Nota

   Los endpoints de recursos que están disponibles para cada recurso de sección dependen del tipo de actividad de Four51 seleccionada para la operación (es decir, crear, leer, actualizar, actualizar por parches o eliminar).

   

6. Jitterbit procederá a crear una estructura de solicitud y respuesta de API que permitirá que los datos se creen a través de la API de OrderCloud. Debería aparecer una nueva pestaña en Studio llamada Four51 Create Activities. Puedes renombrar tu actividad de creación aquí si lo deseas; en el ejemplo, la nuestra se llama "Four51 Create - Buyer > Addresses > Create New Address." También puedes usar los botones + - o las flechas para expandir todos los elementos dentro de cada estructura.

   

   Nota

   El "xp" en la estructura anterior significa "Extended Properties" y es parte de la API de OrderCloud. Esta propiedad te permite agregar campos personalizados a la mayoría de los objetos. Para aprender más sobre cómo usar la propiedad XP, consulta Four51 connector advanced.

7. A continuación, en la misma pantalla, haz clic en el botón Create Operation ubicado bajo Use in an Integration en la esquina superior derecha. Esto creará la operación de Jitterbit que creará una nueva dirección de comprador en Four51.

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

   

   Nota

   Los íconos de 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 disco múltiple 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 ahora está 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.

Puedes 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, o puedes 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.

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 de Design Studio de nuestra documentación.

• Source: Con el propósito de simplificar este ejemplo, la fuente estará codificada de forma fija. Por lo tanto, eliminaremos la fuente haciendo clic derecho en el ícono de la fuente en el gráfico de operación y seleccionando Remove From Graph.

  Nota

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

• Target: Haz doble clic en el ícono de Target. En el ejemplo, registraremos la respuesta de la API de OrderCloud en un archivo de texto temporal para proporcionar información sobre el éxito o el fracaso. Haz clic en el botón Create New Target, dale a tu objetivo un Name (por ejemplo, 'Create Target'). A continuación, para este ejemplo queremos escribir en la ubicación de almacenamiento temporal predeterminada en nuestro agente privado, así que seleccionamos un Type de "Temporary Storage" y entramos un Filename de 'Create_File.txt' para el ejemplo.

  Nota

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

• Request: Haz doble clic en el ícono de Request y selecciona Create New Transformation. Esto abrirá el Transformation Wizard 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 Transformations.

  1. En la primera pantalla, Nombre, proporciona un Nombre para tu transformación o déjalo como el predeterminado. Luego utiliza el menú desplegable Fuente para seleccionar la fuente de la transformación. En el ejemplo, nuestra fuente está codificada, así que seleccionaremos "Ninguno". Haz clic en Finalizar para continuar.

  2. La pestaña Transformaciones debería abrirse donde puedes completar tu mapeo. Usa el + para expandir los elementos en el árbol de destino a la derecha. En una transformación estándar, arrastrarías y soltarías cada campo que te gustaría mapear de un árbol a otro. Para este ejemplo, para codificar la fuente, haz doble clic en cada campo del lado del destino y escribe los siguientes valores utilizados en el ejemplo en el script:

     DESTINO: ENTRADA > CrearNuevaDirección > Parámetros	Script
     buyerID	<trans> "TestBuyerID0001" </trans>

     Nota

     El buyerID anterior proviene del ID de la Organización Compradora existente en la que queremos crear la nueva dirección. El buyerID de ejemplo TestBuyerID0001 ya fue creado en la instancia de OrderCloud para este ejemplo. Consulta Organización Compradora en prerrequisitos del conector Four51 para más información.

     DESTINO: ENTRADA > CrearNuevaDirección > ParámetrosDeSolicitud	Script
     ID	<trans> "TestAddressID0000" </trans>
     NombreDeLaEmpresa	<trans> "Test Company" </trans>
     Nombre	<trans> "First" </trans>
     Apellido	<trans> "Last" </trans>
     Calle1	<trans> "Main Street" </trans>
     Ciudad	<trans> "San Francisco" </trans>
     Estado	<trans> "CA" </trans>
     CódigoPostal	<trans> "123456" </trans>
     País	<trans> "US" </trans>
     Teléfono	<trans> "123456789" </trans>
     NombreDeLaDirección	<trans> "Test_Address" </trans>

     Nota

     Toda la información proporcionada arriba es nueva y no existe ya en la instancia de ejemplo de OrderCloud.

     Después de codificar la fuente, 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 objetivo de la transformación. En el ejemplo queremos usar la respuesta de la API de OrderCloud, así que seleccionamos "Four51 Function Response." Haz clic en Next para continuar.

  2. En la siguiente pantalla, Target, selecciona el botón de opción para el tipo de actividad de la que deseas usar la respuesta. En este caso, queremos usar la respuesta de la actividad de creación que acabamos de configurar, así que elige "Create." Haz clic en Next para continuar.

  3. La pantalla de Target ahora mostrará un menú desplegable para seleccionar la actividad. Elige la actividad de creación que acabas de configurar. Las estructuras de solicitud y respuesta asociadas con la actividad de creación seleccionada deberían aparecer ahora. Haz clic en Finish para continuar.

  4. La pestaña de Transformations debería abrirse donde puedes completar tu mapeo. Usa el + para expandir los lados de origen y destino. Haz clic y arrastra la carpeta "OUTPUT" del lado izquierdo (lado de origen) a la carpeta "OUTPUT" del lado derecho (lado de destino). Tu pantalla de mapeo debería verse similar a la que se muestra a continuación.

     

Tu operación configurada debería verse similar al ejemplo que se muestra a continuación.

Desplegando y ejecutando la operación

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

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

2. Luego haz clic en el icono 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 icono de Estado para ver cualquier mensaje de registro.

   

4. También deberías ver ahora la respuesta de salida que se mapeó a tu archivo de destino 'Create_File.txt'. En el ejemplo, el archivo ahora se crea en el almacenamiento temporal en el agente privado (es decir, por defecto '/tmp/jitterbit/TemporaryStorage' para Linux o 'C:\Windows\Temp\Jitterbit\' para Windows). El estado de '1' indica que la operación fue exitosa.

   <?xml version="1.0" encoding="UTF-8"?>
   <ns:OUTPUT xmlns:ns="urn:F51oln-res:document:F51oln:oln:entities">
       <CreateNewAddress>
           <Status>1</Status>
           <Items>
               <Item>
                   <ID>TestAddressID0000</ID>
                   <CompanyName>Test Company</CompanyName>
                   <FirstName>First</FirstName>
                   <LastName>Last</LastName>
                   <Street1>Main Street</Street1>
                   <City>San Francisco</City>
                   <State>CA</State>
                   <Zip>123456</Zip>
                   <Country>US</Country>
                   <Phone>123456789</Phone>
                   <AddressName>Test_Address</AddressName>
               </Item>
           </Items>
       </CreateNewAddress>
   </ns:OUTPUT>
   

5. Además, cuando revises la Consola API de OrderCloud bajo Comprador > Direcciones, deberías encontrar la nueva dirección de comprador creada.