Actualización del Conector del Autodesk Fusion Lifecycle

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

crear Nueva Actualización del Fusion Lifecycle

• Haga clic en la flecha a la derecha del icono Conector en la barra de herramientas superior

  

• El menú emergente muestra todos los conectores disponibles.

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

• El asistente de actualización de Fusion Lifecycle muestra la pantalla Extremo.

Asistente de Actualización del Fusion Lifecycle

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

• Seleccione el Extremo del Fusion Lifecycle.

• Antes de poder crear funciones de Fusion Lifecycle en Jitterbit, debe crear al menos un extremo de Fusion Lifecycle.

• Si aún no ha creado al menos un Extremo del Fusion Lifecycle, seleccione Crear nuevo en la lista desplegable Extremos del Fusion Lifecycle disponibles. Consulte Creación de un Extremo del Fusion Lifecycle para obtener instrucciones para crear un nuevo extremo.

• Si ya ha creado uno o más Extremos del Fusion Lifecycle, Seleccione un punto final de la lista desplegable Extremos del Fusion Lifecycle disponibles.

  

• Haga clic en el botón ProbarConexión.

• Si aún no ha iniciado sesión en su servidor Jitterbit, Escriba la Contraseña en la ventana emergente de inicio de sesión del servidor Jitterbit y Haga clic en el botón Iniciar sesión.

• Una ventana emergente indica que los parámetros se enviaron al servidor y que la prueba está en proceso, seguida de una ventana emergente que indica que la conexión fue exitosa. Haga clic en Aceptar.

• Haga clic en el botón Siguiente para mostrar la pantalla Espacio de trabajo y seleccione un espacio de trabajo.

• Para volver a la pantalla anterior, Haga clic en el botón Volver.

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

Seleccione un Espacio de Trabajo

La pantalla Área de trabajo muestra la lista de todas las áreas de trabajo de Fusion Lifecycle disponibles para el inquilino a través del extremo seleccionado.

• Filtro: Escriba las primeras letras de la descripción del espacio de trabajo o el número de identificación del espacio de trabajo en el cuadro Filtro en la parte superior de la pantalla para filtrar la lista.

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

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

• Haga clic en el botón Finalizar en la parte inferior de la pantalla para mostrar la pestaña Actualización del Fusion Lifecycle, incluidas las estructuras XML de solicitud y respuesta.

• Para volver a la pantalla anterior, Haga clic en el botón Volver.

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

Estructuras XML de Solicitud y Respuesta

Las estructuras XML de solicitud y respuesta están definidas por la función Fusion Lifecycle Upsert y la estructura del espacio de trabajo específico seleccionado como 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 Fusion Lifecycle Upsert. 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 tiene como valor predeterminado "Fusion Lifecycle Upsert" más el nombre del espacio de trabajo seleccionado como Objeto (Categorías de elementos (id:12) en este ejemplo). Para cambiar el nombre de la función, Escriba el Nombre en el campo Nombre en la esquina superior izquierda de la pantalla.

• Haga clic en el ícono 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 el acceso a los asistentes Crear solicitud y Crear respuesta desde el diagrama de flujo de trabajo.

• Crear solicitud: Inicia el Asistente de Transformación Crear solicitud.

• Crear respuesta: Inicia el Asistente de Transformación Crear respuesta.

Asistente para Crear una Solicitud de Transformación

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

• Aparece el cuadro de diálogo Asistente de Transformación.

  

• Nombre: El nombre de la Transformación de solicitud tiene como valor predeterminado "Fusion Lifecycle Upsert", más el nombre del objeto del espacio de trabajo seleccionado (Categorías de elementos (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. Al seleccionar Ninguno se activa el botón Finalizar.

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

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

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

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

• Para volver a la pantalla anterior, Haga clic en el botón Volver.

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

• Consulte Descripción general de los datos de Transformación para informacion adicional.

  

• Los campos de datos de origen 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 artículos (id:12)) se muestran en la mitad derecha de la pantalla.

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

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

• El Generador de fórmulas se muestra en la mitad izquierda de la pantalla.

  

• Escriba la fórmula o el valor de datos en el Creador de fórmulas para actualizar o crear un elemento específico en el espacio de trabajo del Fusion Lifecycle. Consulte Uso del generador de fórmulas y Secuencias de comandos para informacion adicional.

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

• Haga clic en el botón Probar en la esquina inferior izquierda para validar el secuencia de comandos.

• Haga clic Aceptar para completar la Transformación de la solicitud.

  

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

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

• Haga clic en 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 implemente en el servidor Jitterbit. Haga clic en Desplegar en la barra de herramientas en la esquina superior derecha de la pantalla para desplegar la Transformación de solicitud en el servidor Jitterbit.

• Haga clic en 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 Generador de fórmulas.

• Si la Transformación de la solicitud no se ha guardado ni implementado antes de la prueba, se mostrará el siguiente mensaje:

  

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

  

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

  

• Los valores de datos que se utilizarán para actualizar o crear la categoría de elemento se muestran a la derecha de los campos 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 Generador de fórmulas. En los casos en que un archivo fuente sea parte de la operación, puede alternar entre los valores de un elemento de entrada múltiple haciendo clic en el control "1 de N" de la carpeta correspondiente. Puede presionar Mayús y hacer clic para ir a una instancia anterior o hacer clic derecho para ir a una instancia arbitraria.

• Consulte Prueba de datos fuente para informacion adicional.

asistente para Crear Transformación de Respuesta

• 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.

  

• Aparece el Asistente de Transformación.

  

• Nombre: El nombre de la Transformación de respuesta tiene de forma predeterminada "Fusion Lifecycle Upsert", más el nombre del objeto del espacio de trabajo seleccionado en los pasos anteriores (Categorías de elementos (id:12) en este ejemplo).

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

• Fuente: El origen se establece automáticamente de forma predeterminada en la función Fusion Lifecycle Upsert Connector y el objeto de espacio de trabajo seleccionado en los pasos anteriores (Categorías de elementos (id:12) en este ejemplo).

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

• En este ejemplo, enviamos los datos a un archivo de Texto.

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

• Para volver a la pantalla anterior, Haga clic en el botón Volver.

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

• Vea Objetivos y Transformaciones para tipos adicionales de formatos de archivos de destino.

  

• Definiciones de formatos de archivo disponibles: Seleccione un formato de archivo de la lista desplegable.

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

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

  • Se muestra la definición del archivo y se activa el botón Finalizar.
  • Revise la estructura existente y edite los segmentos/campos del archivo según sea necesario.
  • Haga clic Finalizar para completar la definición del archivo y continuar creando la Transformación de respuesta.
  • Nombre: Escriba 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 denomina Categoría de inserción de prueba.

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

  • Haga clic en el botón Crear desde archivo en la esquina inferior izquierda de la pantalla.
  • Una ventana emergente muestra el cuadro de diálogo para crear un nuevo formato de archivo a partir de un archivo de modelo existente.
  • Consulte Creación de una definición de documento de texto a partir de un archivo de plantilla para informacion adicional.

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

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

• Haga clic en el botón de opción correspondiente para seleccionar Delimitado por caracteres o Anchos de campo fijos.

• Haga 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 de campo: Escriba el Nombre del campo en el cuadro Nombre de campo.

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

• Validación de campo: La validación de campo es opcional para cada campo. Haga clic en Validación en el extremo derecho 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 Nombre de 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 Asistente de Transformación para guardar la nueva definición de archivo y mostrar la pantalla Transformación de respuesta.

• Para volver a la pantalla anterior, Haga clic en el botón Volver.

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

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

• Consulte Asistente de Transformación y Descripción general de Transformaciones para informacion adicional.

  

• La estructura XML de Fusion Lifecycle Upsert se muestra en la mitad izquierda de la pantalla como origen de datos y el formato del archivo de respuesta se muestra en la mitad derecha de la pantalla como destino.

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

• Profundice en el árbol de datos y Seleccione los campos Fuente que se asignarán al destino.

  

• Haga clic en el Campo de datos deseado en la Fuente (columna de la izquierda).

• Arrastre y suelte el campo seleccionado en el Campo apropiado en el Destino (columna derecha).

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

  

• La asignación válida se indica mediante líneas verdes entre los elementos de las columnas Origen y Destino y, además, por la presencia de un cuadrado azul junto a cada nombre de campo asignado válidamente.

• Una línea roja indica una asignación no válida.

• 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.

  

• Complete el mapeo en la pestaña Transformaciones arrastrando y soltando desde el Origen a la izquierda hasta el Destino a la derecha. Cuando lo haga, una línea verde conectará cada elemento de origen y de destino, y aparecerá un cuadrado azul a la izquierda tanto del elemento de origen como del elemento de destino. Consulte Mapeo de Transformación para informacion adicional.

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

• Haga clic en 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 implemente en el servidor Jitterbit. Haga clic en Desplegar en la barra de herramientas en la esquina superior derecha de la pantalla para desplegar la Transformación de respuesta en el servidor Jitterbit.

• Haga clic en 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 cargue datos de prueba para completar el proceso.

• Si la Transformación de respuesta no se ha guardado ni implementado antes de la prueba, se mostrará el siguiente mensaje:

  

• Haga 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 inserción de prueba.

  

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

Crear Operación

Las operaciones se utilizan para definir qué hará su proceso de integración y cuándo se realizará. Las operaciones pueden llamarse entre sí en función de eventos como En caso de éxito o En caso de fracaso, en función de condiciones definidas o en función de un cronograma.

• Haga clic en la pestaña Actualizaciones del Fusion Lifecycle.

  

• Haga clic en el botón Crear operación en la esquina superior derecha de la pantalla.

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

  

Pedido

• Haga doble clic en el cuadro Solicitar en el diagrama de flujo de trabajo.

  

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

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

• En este ejemplo, se selecciona Categorías de elementos de inserción de My Fusion Lifecycle (id:12) – Solicitud.

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

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

• Para crear una nueva solicitud, Haga clic en el botón Crear nueva Transformación para iniciar la pestaña Asistente para crear Transformación de solicitud. Consulte Asistente para crear una solicitud de Transformación para obtener instrucciones para 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ó Categorías de elementos de inserción de My Fusion Lifecycle (id:12) – Solicitud. Esta solicitud se creó sin una fuente (no se seleccionó ninguna como fuente). Como resultado, el cuadro Fuente se elimina automáticamente del gráfico de flujo de trabajo de Operación.

Respuesta

• Haga doble clic en el cuadro 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, Haga clic en el Nombre de una Respuesta en la lista.

• En este ejemplo, se selecciona Categorías de elementos de inserción de My Fusion Lifecycle (id:12) – Respuesta.

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

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

• Para crear una nueva respuesta, Haga clic en el botón Crear Nueva Transformación para iniciar la pestaña Asistente para crear una Transformación de respuesta. Consulte Asistente para crear una solicitud de Transformación para obtener instrucciones para crear una nueva respuesta.

• El nombre de la respuesta seleccionada, Categorías de elementos de inserción de My Fusion Lifecycle (id:12) – Respuesta, se muestra en el cuadro de flujo de trabajo de Respuesta.

Objetivo

• Haga doble clic en el cuadro Destino en el gráfico de flujo de trabajo.

  

• La ventana emergente Seleccionar destino muestra una lista de archivos existentes.

• Para seleccionar un archivo existente, Haga clic en el Nombre de un Archivo en la lista.

• Haga clic en el botón Aceptar en la parte inferior de la ventana para continuar creando la operación.

• Haga clic en el botón Cancelar en la parte inferior de la ventana para cerrarla.

• Para crear un archivo nuevo, Haga clic en el botón Crear Nuevo destino para iniciar la pestaña Destinos.

  

• Nombre: escriba un nombre para el nuevo destino en el campo Nombre. En este ejemplo, el destino se denomina Categoría de inserción de prueba.

• 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. Busque y seleccione la carpeta adecuada.

• Nombre de archivo(s): escriba el Nombre del archivo de destino en el cuadro Nombre de 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 Destino.

• Vea Objetivos para informacion adicional.

  

• Haga clic en la pestaña Operaciones.

• El nombre de la función asociada se muestra en cada componente del gráfico de flujo de trabajo:

  • Solicitud: My Fusion Lifecycle Upsert Categorías de elementos (id:12) - Solicitud
  • Respuesta: Mis categorías de elementos de inserción del Fusion Lifecycle (id:12) - Respuesta
  • Objetivo: Categoría de inserción de prueba

• Haga clic en 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 implemente en el servidor Jitterbit.

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

Prueba de Transformación de Respuesta

• Haga clic en la pestaña Transformaciones.

  

• Una pantalla emergente muestra cada una de las transformaciones asociadas.

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

• Haga clic en el icono Operación de prueba que utiliza Transformación en la esquina inferior izquierda de la pantalla.

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

  

• Los valores de los 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 = Actualización y Éxito = Verdadero. La operación actualizó exitosamente la descripción de 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á 1 conjunto de valores. En los casos en que un archivo fuente sea parte de la operación, puede alternar entre la lista de múltiples valores de resultados haciendo clic en el control "1 de N" de la carpeta correspondiente. Puede presionar Mayús y hacer clic 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 Respuesta de Transformación.

Prueba de Operación

• Haga clic en la pestaña Operaciones.

  

• Haga clic en Relámpago en la esquina superior derecha de la pantalla para colocar la Operación en la cola para su ejecución.

• El monitor de funcionamiento aparece en la parte inferior de la pantalla.

• Aparece una barra de progreso en el extremo derecho mientras se ejecuta la operación.

• Las estadísticas de ejecución también se muestran en el monitor de operación: estado, hora de recepción, hora de inicio, hora de finalización y duración.

• Inicie un editor de texto y abra Test Upsert Category.txt para ver los resultados de la operación.