Saltar al contenido

Actualización del Conector Four51

La actividad de actualización de Four51 disponible dentro del Conector Four51 le permite crear datos nuevos o reemplazar datos existentes en Four51 a través de la API de OrderCloud. Se debe proporcionar una identificación única.

Con una actividad de actualización de Four51, se crearán o reemplazarán todos los campos del objeto asociado. Si hay campos obligatorios, se le pedirá que proporcione un valor para estos campos, incluso si ya existen datos dentro de los campos obligatorios. La razón de esto es que una actividad de actualización de Four51 actualiza o reemplaza completamente cualquier dato existente para el objeto.

La actualización total o parcial de los campos de objetos es una diferencia importante entre las actividades de actualización de Four51 y de actualización del parche Four51. Si, en cambio, desea actualizar solo los campos especificados para el objeto asociado, consulte Actualización del parche del conector Four51.

Nota

Antes de configurar una operación de actualización de Four51, deberá tener definido un extremo Four51. Para obtener más información sobre la creación de un extremo, consulte Extremo del conector Four51.

Esta página describe cómo crear datos nuevos o reemplazar datos existentes en Four51 usando un ejemplo de reemplazo de una dirección de comprador existente usando Jitterbit. Este ejemplo reemplaza la misma dirección del comprador que se creó como ejemplo en Crear conector Four51.

Importante

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 de actualización, definir los componentes de la operación e desplegar y ejecutar la operación.

Crear una Operación de Actualización Four51

Nota

Si aún no está familiarizado con Jitterbit, consulte Comenzar o Design Studio para obtener información detallada sobre cómo utilizar el producto.

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

    • Vaya a Archivo > Nuevo > Conectores > Nueva actualización de Four51.
    • En el árbol de la izquierda, debajo de Conectores, haga clic derecho en la categoría Four51 y luego seleccione Nueva actualización de Four51.
    • En el árbol de la izquierda debajo de Conectores, haga doble clic en la categoría Four51, luego haga clic derecho en Actividades de actualización de Four51 y seleccione Nueva actualización de Four51.
    • En la barra de herramientas superior, haga clic en el icono del conector (pieza de rompecabezas naranja) adjunto. En la ventana emergente, seleccione Four51, luego seleccione Actualización de Four51.
  2. La pantalla Extremo del Asistente de actualización Four51 debería abrirse en la vista principal de Studio. Esta pantalla le solicita que seleccione el extremo en el que desea crear o reemplazar datos. Ya debería haber configurado su extremo en Extremo del conector Four51. Utilice el menú desplegable para seleccionar el extremo apropiado. Haga clic en Siguiente cuando haya terminado.

    adjunto

  3. Las siguientes pantallas del Asistente de actualización de Four51 lo ayudan a profundizar hasta el objeto específico en el que desea actualizar los datos. La primera de estas pantallas, Sección, le pide que seleccione uno de los principales enumerados. categorías de nivel dentro de Four51: "Autenticación", "Comprador", "Pedidos", "Organización" o "Perspectiva del usuario".

    Nota

    Puede determinar qué selecciones realizar consultando la API de OrderCloud. Por ejemplo, estas cinco categorías de nivel superior se corresponden directamente con las que figuran en el lado izquierdo de la Consola API de OrderCloud. El resto de pantallas de selección de objetos también siguen la organización de la API de OrderCloud.

    En el ejemplo, queremos reemplazar completamente una dirección de comprador existente, por lo que seleccionamos la sección "Comprador" y hacemos clic en Siguiente para continuar.

    adjunto

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

    adjunto

  5. La pantalla de selección final en el Asistente de actualización Four51, llamada** Extremo de recursos , muestra los objetos finales disponibles para el recurso seleccionado. En el ejemplo, para reemplazar una dirección existente, seleccionamos la opción "Crear o actualizar dirección". Haga clic en **Finalizar para continuar.

    Nota

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

    adjunto

  6. Luego, Jitterbit procederá a crear una estructura de solicitud y respuesta API que permitirá crear o reemplazar datos a través de la API de OrderCloud. Debería aparecer una nueva pestaña en Studio llamada Actividades de actualización de Four51. Puede cambiar el nombre de su actividad de actualización aquí si lo desea; en el ejemplo, el nuestro se llama "Actualización Four51 - Comprador > Direcciones > Crear o actualizar dirección". También puede utilizar los botones o flechas + - para expandir todos los elementos dentro de cada estructura.

    adjunto

    Nota

    El "xp" en la estructura anterior significa "Propiedades extendidas" y es parte de la API de OrderCloud. Esta propiedad le permite agregar campos personalizados a la mayoría de los objetos. Para obtener más información sobre cómo utilizar la propiedad XP, consulte Conector Four51 avanzado.

  7. 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 creará una nueva dirección de comprador o reemplazará una existente en Four51.

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

    adjunto

    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 actualizació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.

Puede volver a la representación gráfica de la operación que ha creado y hacer doble clic en cada icono para configurar cada componente, o puede crear Fuente, Solicitud, Respuesta y Objetivo por separado y luego arrástrelos y suéltelos desde el árbol de la izquierda directamente en los íconos en la representación visual de su operación.

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: Para simplificar este ejemplo, la fuente estará codificada. Por lo tanto, eliminaremos la fuente haciendo clic derecho en el icono de la fuente en el gráfico de operación y seleccionando Eliminar del gráfico.

    Nota

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

  • Destino: haga doble clic en el icono Objetivo. 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. Haga clic en el botón Crear nuevo destino y asigne un Nombre a su destino (por ejemplo, "Actualizar destino"). A continuación, para este ejemplo queremos escribir en la ubicación de almacenamiento temporal predeterminada en nuestro Agente Privado, por lo que seleccionamos un Tipo de "Almacenamiento temporal" e ingresamos un Nombre de archivo de 'Update_File.txt' para el ejemplo.

    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 la fuente de la transformación. En el ejemplo, nuestra fuente está codificada, por lo que seleccionaremos "Ninguno". Haga clic en Finalizar para continuar.

    2. Debería abrirse la pestaña Transformaciones donde podrás completar tu mapeo. Utilice + para expandir los elementos en el árbol de destino de la derecha. En una transformación estándar, arrastraría y soltaría cada campo que desea asignar de un árbol a otro. Para este ejemplo, para codificar el origen, haga doble clic en cada campo en el lado de destino y escriba los siguientes valores utilizados en el ejemplo en el secuencia de comandos:

      OBJETIVO: ENTRADA > CreateorUpdateAddress > Parámetros Secuencia de Comandos
      ID del comprador <trans>
      "TestBuyerID0001"
      </trans>
      ID de dirección <trans>
      "TestAddressID0000"
      </trans>

      Nota

      El ID de comprador anterior es el ID existente de la organización compradora en la que se encuentra la dirección, y el ID de dirección anterior es el ID existente de la nueva dirección que se creó durante la [Creación del conector Four51. ]](/es/design-studio/design-studio-reference/connectors/four51-connector/four51-connector-create) ejemplo.

      OBJETIVO: ENTRADA > CreateorUpdateAddress > RequestParameters Secuencia de Comandos
      identificación <trans>
      "TestAddressID0000"
      </trans>
      Nombre de la empresa <trans>
      "Test 2 Company"
      </trans>
      Nombre <trans>
      "Replaced First"
      </trans>
      Apellido <trans>
      "Replaced Last"
      </trans>
      Calle1 <trans>
      "1234 Main Street"
      </trans>
      Ciudad <trans>
      "Los Angeles"
      </trans>
      Estado <trans>
      "CA"
      </trans>
      Cremallera <trans>
      "654321"
      </trans>
      País <trans>
      "US"
      </trans>
      Teléfono <trans>
      "987654321"
      </trans>
      Nombre de dirección <trans>
      "Test_2_Address"
      </trans>

      Nota

      Los valores enumerados anteriormente reemplazarán los creados durante la Creación del conector Four51 ejemplo.

      Después de codificar la fuente, su mapeo de transformación debería verse similar al que se muestra a continuación.

      adjunto

  • 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 Destino para seleccionar el destino de la transformación. En el ejemplo queremos utilizar la respuesta de la API de OrderCloud, por lo que seleccionamos "Respuesta de función Four51 ". Haga clic en Siguiente para continuar.

    2. En la siguiente pantalla, Objetivo, seleccione el botón de opción para el tipo de actividad cuya respuesta desea utilizar. En este caso, queremos utilizar la respuesta de la actividad de actualización que acabamos de configurar, así que elija "Actualizar". Haga clic en Siguiente para continuar.

    3. La pantalla Objetivo ahora mostrará un menú desplegable para seleccionar la actividad. Elija la actividad de actualización que acaba de configurar. Ahora deberían aparecer las estructuras de solicitud y respuesta asociadas con la actividad de actualización seleccionada. Haga clic en Finalizar para continuar.

    4. La pestaña Transformaciones debería abrirse donde puedes completar tu mapeo. Utilice el + para expandir los lados de origen y destino. Haga clic y arrastre la carpeta "SALIDA" desde el lado izquierdo (lado de origen) a la carpeta "SALIDA" en el lado derecho (lado de destino). Su pantalla de mapeo ahora debería verse similar a la siguiente.

      adjunto

Su operación configurada debería ser similar al ejemplo que se muestra a continuación.

adjunto

Despliegue y Ejecución de la Operación

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

  1. Desde la pestaña Operaciones, haga clic en desplegar adjunto icono.

  2. Luego haga clic en ejecutar adjunto 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.

    adjunto

  4. Ahora también debería ver la respuesta de salida que se asignó a su archivo de destino 'Update_File.txt'. En el ejemplo, el archivo ahora se crea en el almacenamiento temporal del Agente Privado (es decir, el valor predeterminado '/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">
        <CreateorUpdateAddress>
            <Status>1</Status>
            <Items>
                <Item>
                    <ID>TestAddressID0000</ID>
                    <CompanyName>Test 2 Company</CompanyName>
                    <FirstName>Replaced First</FirstName>
                    <LastName>Replaced Last</LastName>
                    <Street1>1234 Main Street</Street1>
                    <City>Los Angeles</City>
                    <State>CA</State>
                    <Zip>654321</Zip>
                    <Country>US</Country>
                    <Phone>987654321</Phone>
                    <AddressName>Test_2_Address</AddressName>
                </Item>
            </Items>
        </CreateorUpdateAddress>
    </ns:OUTPUT>
    
  5. Además, cuando revisa la Consola API OrderCloud.io en Comprador > Direcciones, debería encontrar la dirección del comprador reemplazada con la nueva información.

    adjunto