Conector de Autodesk Fusion Lifecycle Upsert en Jitterbit Design Studio

La función Upsert de Fusion Lifecycle permite actualizar un elemento existente en el espacio de trabajo de Fusion Lifecycle para su uso en integraciones de Jitterbit. Además, si el elemento no existe, se crea un nuevo elemento.

Crear nuevo Upsert de Fusion Lifecycle

• Haz clic en la flecha a la derecha del ícono de Conector en la barra de herramientas superior.

  

• El menú emergente muestra todos los conectores disponibles.

• Haz clic en la función Upsert de Fusion Lifecycle en la lista.

• El Asistente de Upsert de Fusion Lifecycle muestra la pantalla de Endpoint.

Asistente de Upsert de Fusion Lifecycle

El Asistente de Upsert de Fusion Lifecycle te guía a través del proceso de creación de una nueva función Upsert. El primer paso es seleccionar un Endpoint de Fusion Lifecycle.

• Selecciona el Endpoint de Fusion Lifecycle.

• Antes de poder crear funciones de Fusion Lifecycle en Jitterbit, debes crear al menos un endpoint de Fusion Lifecycle.

• Si aún no has creado al menos un Endpoint de Fusion Lifecycle, selecciona Crear Nuevo en la lista desplegable de Endpoints de Fusion Lifecycle Disponibles. Consulta Creando un endpoint de Fusion Lifecycle para instrucciones sobre cómo crear un nuevo endpoint.

• Si ya has creado uno o más Endpoints de Fusion Lifecycle, Selecciona un Endpoint de la lista desplegable de Endpoints de Fusion Lifecycle Disponibles.

  

• Haz clic en el botón TestConnection.

• Si aún no has iniciado sesión en tu servidor Jitterbit, Escribe la Contraseña en la ventana emergente de inicio de sesión del servidor Jitterbit y Haz clic en el botón Login.

• Una ventana emergente indica que los parámetros fueron enviados al servidor y que la prueba está en proceso, seguida de una ventana emergente que indica que la conexión fue exitosa. Haz clic en OK.

• Haz clic en el botón Next para mostrar la pantalla de Workspace y seleccionar un espacio de trabajo.

• Para regresar a la pantalla anterior, Haz clic en el botón Back.

• Haz clic en el botón Cancel para cerrar el asistente sin guardar tus entradas.

Selecciona un espacio de trabajo

La pantalla de Workspace muestra la lista de todos los espacios de trabajo de Fusion Lifecycle disponibles para el inquilino a través del endpoint seleccionado.

• Filtrar: Escribe las primeras letras de la descripción del espacio de trabajo o el número de ID del espacio de trabajo en el cuadro de Filter en la parte superior de la pantalla para filtrar la lista.

• Actualizar: Haz clic en el botón Refresh en la esquina inferior derecha de la pantalla para restaurar la lista completa de espacios de trabajo.

• Haz clic en el Nombre del espacio de trabajo específico al que deseas acceder. El espacio de trabajo seleccionado es el Objeto para la función Upsert de Fusion Lifecycle.

• Haz clic en el botón Finish en la parte inferior de la pantalla para mostrar la pestaña Upsert de Fusion Lifecycle, incluyendo las estructuras XML de Solicitud y Respuesta.

• Para regresar a la pantalla anterior, Haz clic en el botón Back.

• Haz clic en el botón Cancel para cerrar el asistente sin guardar tus entradas.

Estructuras XML de solicitud y respuesta

Las estructuras XML de Solicitud y Respuesta están definidas por la función Upsert de Fusion Lifecycle y la estructura del espacio de trabajo específico seleccionado como el Objeto de la función Upsert. La estructura XML de Solicitud está representada por un árbol de datos de los campos disponibles para crear nuevos elementos o actualizar elementos existentes a través de la función Upsert de Fusion Lifecycle. La estructura XML de Respuesta está representada por un árbol de datos de campos disponibles dentro de los elementos nuevos o actualizados para recuperar valores de datos.

• Nombre: El nombre de la función Upsert se establece por defecto como "Fusion Lifecycle Upsert" más el nombre del espacio de trabajo seleccionado como el Objeto (Categorías de Ítems(id:12) en este ejemplo). Para renombrar la función, Escriba el Nombre en el campo de Nombre en la esquina superior izquierda de la pantalla.

• Haga clic en el ícono de Guardar en la esquina superior derecha de la pantalla.

• Haga clic en las Flechas Grises a la izquierda de cada carpeta o Haga Doble Clic en la Carpeta para expandir y ver los campos disponibles en cada estructura.

• Para completar la función Fusion Lifecycle Upsert, Haga clic en uno de los botones en la sección "Usar en una Integración" en la esquina superior derecha de la pantalla.

• Crear Operación: Muestra la representación gráfica del flujo de trabajo de la función Upsert y permite acceder a los asistentes de Crear Solicitud y Crear Respuesta desde dentro del diagrama de flujo de trabajo.

• Crear Solicitud: Inicia el asistente de transformación de solicitud de creación.

• Crear Respuesta: Inicia el asistente de transformación de respuesta de creación.

Asistente de transformación de solicitud de creación

• Haga clic en el botón de Crear Solicitud en la esquina superior derecha de la pestaña.

• El diálogo del Asistente de Transformación se muestra.

  

• Nombre: El nombre de la Solicitud de Transformación se establece automáticamente como "Fusion Lifecycle Upsert", más el nombre del objeto del espacio de trabajo seleccionado (Categorías de Ítems(id:12) en este ejemplo).

• Escriba el nombre apropiado en el campo Nombre en la esquina superior izquierda de la pantalla.

• Fuente: Seleccione la fuente de los datos para la Solicitud en la lista desplegable.

• Para actualizar o crear un elemento directamente desde Jitterbit Studio, Seleccione Ninguno. Seleccionar Ninguno activa el botón Finalizar.

• Seleccionar un tipo de fuente diferente activa el botón Siguiente para continuar definiendo la estructura de la fuente.

• Destino: El destino se establece automáticamente en la función del conector Upsert de Fusion Lifecycle y el objeto del espacio de trabajo (es decir, Categorías de Elementos(id:12)) seleccionado en pasos anteriores.

• En este ejemplo, estamos actualizando o creando el elemento directamente desde Jitterbit Studio y seleccionamos Ninguno para la fuente.

• Haga clic en el botón Finalizar en la parte inferior de la pantalla para continuar.

• Para regresar a la pantalla anterior, Haga clic en el botón Atrás.

• Haga clic en el botón Cancelar para cerrar el asistente sin guardar sus entradas.

• Consulte Resumen de datos de transformación para obtener información adicional.

  

• Los campos de datos de la fuente se muestran en la mitad izquierda de la pantalla. En este ejemplo, no se seleccionó una fuente.

• Los campos de datos de destino disponibles en el espacio de trabajo seleccionado (es decir, Categorías de Elementos(id:12)) se muestran en la mitad derecha de la pantalla.

• Haga doble clic en el campo de datos Destino específico que se utilizará para el Upsert.

• Para este ejemplo, se seleccionó el campo Category_Code.

• El Constructor de Fórmulas se muestra en la mitad izquierda de la pantalla.

  

• Escriba la fórmula o valor de datos en el Constructor de Fórmulas para actualizar o crear un elemento específico en el espacio de trabajo de Fusion Lifecycle. Consulte Uso del constructor de fórmulas y Scripting para obtener información adicional.

• En este ejemplo, la función Upsert de Fusion Lifecycle actualizará o creará una categoría de ítem en la que el campo CATEGORY_CODE se establece en un valor de 996.

• Haz clic en el botón Test en la esquina inferior izquierda para validar el script.

• Haz clic en OK para completar la Transformación de Solicitud.

  

• En este ejemplo también hemos definido valores en la categoría de ítem actualizada o nueva para el alias, versionID y CATEGORÍA.

• Una solicitud válida al campo de datos específico se indica por la presencia de una línea verde y un cuadrado azul junto al nombre del campo.

• Haz clic en el ícono de Guardar en la barra de herramientas en la esquina superior derecha de la pantalla para guardar la Transformación de Solicitud.

• La Transformación de Solicitud no está activa para su uso hasta que se despliega en el servidor de Jitterbit. Haz clic en el ícono de Desplegar en la barra de herramientas en la esquina superior derecha de la pantalla para desplegar la Transformación de Solicitud en el Servidor de Jitterbit.

• Haz clic en el ícono de Probar Transformación en la esquina inferior izquierda de la pantalla para probar la Transformación de Solicitud.

  Nota

  Esta función de prueba se aplica solo a la Solicitud, no a toda la Operación. Esta función de prueba es útil cuando una Fuente es parte de la Solicitud y la prueba identifica y muestra los datos disponibles en la Fuente. En este ejemplo no se utiliza una Fuente, y la prueba solo muestra los valores ingresados en el Constructor de Fórmulas.

• Si la Transformación de Solicitud no ha sido guardada y desplegada antes de la prueba, se mostrará el siguiente mensaje:

  

• Haz clic en el botón Continuar en la parte inferior del mensaje emergente para desplegar la función Upsert y la Transformación de Solicitud.

  

• Un mensaje muestra el progreso del despliegue de la transformación en el servidor de Jitterbit y la prueba de la transformación.

  

• Los valores de datos que se utilizarán para actualizar o crear la categoría del ítem se muestran a la derecha de los campos de Destino en el árbol de datos.

• En este ejemplo no se utiliza una Fuente, y la prueba solo mostrará el conjunto de valores ingresados en el Constructor de Fórmulas. En los casos donde un archivo de Fuente es parte de la operación, se puede alternar entre los valores de un ítem de múltiples entradas haciendo clic en el control "1 de N" de la carpeta correspondiente. Se puede hacer clic con Shift para ir a una instancia anterior o clic derecho para ir a una instancia arbitraria.

• Consulte Testing source data para información adicional.

Asistente de transformación de respuesta de creación

• Haga clic en la pestaña Fusion Lifecycle Upsert.

• Haga clic en el botón Crear Respuesta en la esquina superior derecha de la pestaña.

  

• Se muestra el Asistente de Transformación.

  

• Nombre: El nombre de la Transformación de Respuesta se establece automáticamente en "Fusion Lifecycle Upsert", más el nombre del objeto del espacio de trabajo seleccionado en pasos anteriores (Categorías de Ítems(id:12) en este ejemplo).

• Escriba el nombre apropiado en el campo Nombre en la esquina superior izquierda de la pantalla.

• Fuente: La fuente se establece automáticamente en la función del Conector Fusion Lifecycle Upsert y el objeto del espacio de trabajo seleccionado en pasos anteriores (Categorías de Ítems(id:12) en este ejemplo).

• Destino: Seleccione el Destino para los datos de respuesta de la lista desplegable. Esto activa el botón Siguiente.

• En este ejemplo, estamos enviando los datos a un archivo Texto.

• Haga clic en el botón Siguiente en la parte inferior de la pantalla para mostrar la pantalla de Destino y definir el formato del archivo.

• Para regresar a la pantalla anterior, Haz clic en el botón Atrás.

• Haz clic en el botón Cancelar para cerrar el asistente sin guardar tus entradas.

• Consulta Targets y Transformations para obtener tipos adicionales de formatos de archivo de destino.

  

• Definiciones de Formato de Archivo Disponibles: Selecciona un formato de archivo de la lista desplegable.

• Selecciona Nuevo Formato de Archivo para crear un nuevo formato. En este ejemplo, estamos creando un nuevo formato de archivo.

• Si seleccionas un formato de archivo existente de la lista desplegable:

  • La definición del archivo se muestra y el botón Finalizar se activa.
  • Revisa la estructura existente y edita los segmentos/campos del archivo según sea necesario.
  • Haz clic en Finalizar para completar la definición del archivo y continuar creando la Transformación de Respuesta.
  • Nombre: Escribe un nombre para la nueva definición de formato de archivo en el campo Nombre. En este ejemplo, la definición de formato de archivo se llama Test Upsert Category.

• Si estás utilizando un archivo existente como plantilla para el nuevo formato de archivo:

  • Haz clic en el botón Crear Desde Archivo en la esquina inferior izquierda de la pantalla.
  • Una ventana emergente muestra el diálogo para crear un nuevo formato de archivo a partir de un archivo de plantilla existente.
  • Consulta Creando una definición de documento de texto a partir de un archivo de plantilla para obtener información adicional.

• Crear Manualmente: En este ejemplo, estamos creando el nuevo formato de archivo manualmente.

• Haz clic en el botón de opción apropiado para seleccionar Simple o Complejo archivo de texto.

• Haz clic en el botón de opción apropiado para seleccionar Delimitado por Caracteres o Anchos de Campo Fijos.

• Haz clic en el botón Crear Manualmente para Definir Propiedades del Segmento.

  

• Haga clic en el botón Nuevo en el lado izquierdo de la pantalla para comenzar a agregar campos al formato de archivo.

• Nombre del campo: Escriba el Nombre del campo en el cuadro de Nombre del campo.

• Tipo: El tipo de campo predeterminado es Cadena. Seleccione el Tipo apropiado de la lista desplegable.

• Validación del campo: La validación del campo es opcional para cada campo. Haga clic en el botón de Validación a la extrema derecha del campo para mostrar la ventana emergente de validación.

• Haga clic en el botón Nuevo para agregar el siguiente campo, y repita los pasos de Nombre del campo y Tipo anteriores para agregar todos los campos deseados.

• Haga clic en el botón Revisar estructura en la esquina inferior izquierda para revisar el formato del archivo.

  

• Haga clic en Aceptar para cerrar la ventana emergente.

• Haga clic en el botón Finalizar en la parte inferior de la pestaña del Asistente de Transformación para guardar la nueva definición de archivo y mostrar la pantalla de Transformación de Respuesta.

• Para regresar a la pantalla anterior, Haga clic en el botón Atrás.

• Haga clic en el botón Cancelar para cerrar el asistente sin guardar sus entradas.

• Consulte Formatos de archivo y Habilitar objetivos de archivo locales para obtener información adicional sobre archivos de texto.

• Consulte Asistente de transformación y Descripción general de transformaciones para obtener información adicional.

  

• La estructura XML de Upsert del ciclo de vida de Fusion se muestra en la mitad izquierda de la pantalla como la fuente de datos y el formato de archivo de respuesta se muestra en la mitad derecha de la pantalla como el objetivo.

• Haga doble clic (o haga clic en el signo +) para expandir el árbol de datos jbresponse en el lado izquierdo de la pantalla.

• Profundizar en el árbol de datos y Seleccionar los campos de Origen que se mapearán al Destino.

  

• Hacer clic en el Campo de datos deseado en el Origen (columna izquierda).

• Arrastrar y soltar el campo seleccionado en el Campo apropiado en el Destino (columna derecha).

• En este ejemplo, el Valor del campo Acción del Origen se mapea al campo Acción en el archivo de texto del Destino.

  

• Un mapeo válido se indica con líneas verdes entre los elementos en las columnas de Origen y Destino y, además, por la presencia de un cuadrado azul junto a cada nombre de campo mapeado válidamente.

• Una línea roja indica un mapeo inválido.

• Una línea amarilla indica que Jitterbit no está seguro de si el mapeo es válido, pero intentará la transformación con este mapeo.

  

• Completar el mapeo en la pestaña de Transformaciones arrastrando y soltando desde el Origen a la derecha al Destino a la izquierda. Al hacerlo, una línea verde conectará cada elemento del Origen y del Destino, y un cuadrado azul aparecerá a la izquierda de ambos, el elemento del Origen y el elemento del Destino. Ver mapeo de transformaciones para información adicional.

• Para salir de esta pantalla, Hacer clic en la X en la esquina superior derecha de la pestaña.

• Hacer clic en el ícono de Guardar en la barra de herramientas en la esquina superior derecha de la pantalla para guardar la Transformación de Respuesta.

• La Respuesta no está activa para su uso hasta que se despliegue en el servidor de Jitterbit. Hacer clic en el ícono de Desplegar en la barra de herramientas en la esquina superior derecha de la pantalla para desplegar la Transformación de Respuesta en el Servidor de Jitterbit.

• Hacer clic en el ícono de Probar Transformación en la esquina inferior izquierda de la pantalla para probar la función de Respuesta.

  Nota

  Esta función de prueba se aplica solo a la Respuesta, no a toda la Operación. Esta función de prueba puede requerir que cargues datos de prueba para completar el proceso.

• Si la Transformación de Respuesta no ha sido guardada y desplegada antes de la prueba, se mostrará el siguiente mensaje:

  

• Haz clic en el botón Continuar en la parte inferior del mensaje emergente para desplegar la Transformación de Respuesta y el formato de archivo de Categoría de Prueba Upsert.

  

• Un mensaje muestra el progreso del despliegue de la transformación en el servidor de Jitterbit y la prueba de la transformación.

Crear operación

Las operaciones se utilizan para definir qué hará tu proceso de integración y cuándo se realizará. Las operaciones pueden llamarse entre sí basándose en eventos como En Éxito o En Fallo, según condiciones definidas, o según un horario.

• Haz clic en la pestaña Fusion Lifecycle Upserts.

  

• Haz clic en el botón Crear Operación en la esquina superior derecha de la pantalla.

• La pestaña de Operaciones muestra el gráfico de flujo de trabajo que representa la función de Upsert de Fusion Lifecycle.

  

Solicitud

• Haz Doble Clic en el cuadro de Solicitud en el gráfico de flujo de trabajo.

  

• La ventana emergente Seleccionar Transformación muestra una lista de Transformaciones de Solicitud existentes.

• Para seleccionar una Solicitud existente, Haz clic en el Nombre de una Solicitud en la lista.

• En este ejemplo, se selecciona el My Fusion Lifecycle Upsert Item Categories(id:12) – Solicitud.

• Haz clic en el botón OK en la parte inferior de la ventana emergente para continuar creando la operación.

• Haz clic en el botón Cancelar en la parte inferior de la ventana emergente para cerrar la ventana.

• Para crear una nueva Solicitud, Haz clic en el botón Crear Nueva Transformación para lanzar la pestaña del Asistente de Transformación de Solicitud. Consulta Asistente de transformación de solicitud para obtener instrucciones sobre cómo crear una nueva Solicitud.

• El nombre de la Solicitud seleccionada se muestra en el cuadro de flujo de trabajo de Solicitud.

• En este ejemplo, se seleccionó la My Fusion Lifecycle Upsert Item Categories(id:12) – Solicitud. Esta Solicitud se creó sin una Fuente (No se seleccionó ninguna como Fuente). Como resultado, el cuadro de Fuente se elimina automáticamente del diagrama de flujo de trabajo de Operación.

Respuesta

• Haz Doble Clic en el cuadro de Respuesta en el diagrama de flujo de trabajo.

  

• La ventana emergente Seleccionar Transformación muestra una lista de Transformaciones de Respuesta existentes.

• Para seleccionar una Respuesta existente, Haz Clic en el Nombre de una Respuesta en la lista.

• En este ejemplo, se selecciona la My Fusion Lifecycle Upsert Items Categories(id:12) – Respuesta.

• Haz Clic en el botón OK en la parte inferior de la ventana emergente para continuar creando la operación.

• Haz Clic en el botón Cancelar en la parte inferior de la ventana emergente para cerrar la ventana.

• Para crear una nueva Respuesta, Haz Clic en el botón Crear Nueva Transformación para abrir la pestaña del Asistente para Crear Transformación de Respuesta. Consulta Asistente para crear transformación de solicitud para obtener instrucciones sobre cómo crear una nueva Respuesta.

• El nombre de la Respuesta seleccionada, My Fusion Lifecycle Upsert Items Categories(id:12) – Respuesta, se muestra en el cuadro de flujo de trabajo de Respuesta.

Destino

• Haz Doble Clic en el cuadro de Destino en el diagrama de flujo de trabajo.

  

• La ventana emergente Seleccionar Destino muestra una lista de Archivos existentes.

• Para seleccionar un Archivo existente, Haz Clic en el Nombre de un Archivo en la lista.

• Haz Clic en el botón OK en la parte inferior de la ventana para continuar creando la operación.

• Haz Clic en el botón Cancelar en la parte inferior de la ventana para cerrar la ventana.

• Para crear un nuevo archivo, haga clic en el botón Crear Nuevo Destino para abrir la pestaña de Destinos.

  

• Nombre: Escriba un nombre para el nuevo Destino en el campo Nombre. En este ejemplo, el Destino se llama Test Upsert Category.

• Tipo: Seleccione el tipo de archivo de la lista desplegable. En este ejemplo, el formato de archivo creado para la operación es un archivo de texto y el tipo es Archivo Local.

• Carpeta: Haga clic en el botón Examinar. Navegue y seleccione la carpeta apropiada.

• Nombre del Archivo(s): Escriba el Nombre del archivo de destino en el cuadro Nombre del Archivo. En este ejemplo, el nombre del archivo es Test Upsert Category.txt.

• El nombre del Destino, Test Upsert Category.txt, se muestra en el cuadro de flujo de trabajo del Destino.

• Consulte Destinos para información adicional.

  

• Haga clic en la pestaña Operaciones.

• El nombre de la función asociada se muestra en cada componente del diagrama de flujo:

  • Solicitud: My Fusion Lifecycle Upsert Item Categories(id:12) - Solicitud
  • Respuesta: My Fusion Lifecycle Upsert Item Categories(id:12) - Respuesta
  • Destino: Test Upsert Category

• Haga clic en el icono de Guardar en la barra de herramientas en la esquina superior derecha de la pantalla para guardar la Operación. La Operación no está activa para su uso hasta que se despliega en el servidor de Jitterbit.

• Haga clic en el icono de Desplegar en la barra de herramientas en la esquina superior derecha de la pantalla para desplegar la Operación en el Servidor de Jitterbit.

Probar desde la transformación de respuesta

• ·Haga clic en la pestaña Transformaciones.

  

• Se muestra una pantalla emergente con cada una de las transformaciones asociadas.

• Haga clic en la ventana emergente de Transformación de Respuesta para mostrar la ventana en tamaño completo.

• Haz clic en el ícono de Probar Operación que usa Transformación en la esquina inferior izquierda de la pantalla.

• Todo el flujo de trabajo de la operación se procesa y los resultados se muestran en la columna de Destino en la pantalla de Respuesta.

  

• Los valores de datos de respuesta se muestran a la derecha de los campos de Destino en el árbol de datos. En este ejemplo, la Acción realizada = Actualizar y Éxito = Verdadero. La operación actualizó con éxito la Descripción de la Categoría del Código de Categoría 996 de BOM 8 a BOM 10.

• En este ejemplo no se utiliza una Fuente, y la prueba solo mostrará el 1 conjunto de valores. En los casos donde un archivo de Fuente es parte de la operación, puedes alternar a través de la lista de múltiples valores de resultado haciendo clic en el control "1 de N" de la carpeta correspondiente. Puedes hacer clic con Shift para ir a una instancia anterior o hacer clic derecho para ir a una instancia arbitraria.

• La operación también creó Test Upsert Category.txt que contiene los mismos resultados que se muestran en la pantalla de Respuesta de Transformación.

Probar desde la operación

• Haz clic en la pestaña de Operaciones.

  

• Haz clic en el ícono de Rayo en la esquina superior derecha de la pantalla para colocar la Operación en la cola para ejecución.

• El monitor de Operación se muestra en la parte inferior de la pantalla.

• Una barra de progreso se muestra en la esquina derecha mientras la Operación se está ejecutando.

• Las estadísticas de ejecución también se muestran en el monitor de Operación: Estado, Hora Recibida, Hora Comenzada, Hora Finalizada y Duración.

• Abre un editor de texto y abre el Test Upsert Category.txt para ver los resultados de la operación.