Autodesk Fusion Lifecycle Connector Obtener
La función Fusion Lifecycle Get le permite recuperar elementos de un espacio de trabajo de Fusion Lifecycle para usarlos en integraciones de Jitterbit.
Nota
Todas las operaciones de Fusion Lifecycle Connector residen dentro de un proyecto. Deberá crear un proyecto antes de poder crear una operación.
Crear un Nuevo Fusion Lifecycle Obtener
-
Haga clic en la flecha a la derecha del ícono Conector en la barra de herramientas superior
-
El menú emergente muestra todos los conectores disponibles.
-
Haga clic en la función Fusion Lifecycle Obtener en la lista.
-
El asistente Get Fusion Lifecycle Get muestra la pantalla Extremo.
Asistente de Obtención del Fusion Lifecycle
El asistente Get de Fusion Lifecycle lo guía a través del proceso de creación de una nueva función Get. 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.
-
Si ya ha creado uno o más Extremos del Fusion Lifecycle, Seleccione un Extremo de la lista desplegable Extremos del Fusion Lifecycle disponibles.
-
Haga clic en el botón Probar conexió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 la prueba está en proceso, seguida de una ventana emergente que indica que la conexión se realizó correctamente. Haga clic en Aceptar.
-
Haga clic en el botón Siguiente para mostrar la pantalla Área de trabajo y seleccione un área de trabajo.
-
Para volver 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.
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 arrendatario a través del extremo seleccionado.
-
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.
-
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 para acceder. El espacio de trabajo seleccionado es el objeto para la función Obtener del Fusion Lifecycle.
-
Haga clic en el botón Finalizar en la parte inferior de la pantalla para mostrar la pestaña Obtener del Fusion Lifecycle, incluidas las estructuras XML de solicitud y respuesta.
-
Para volver 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.
Estructuras XML de Solicitud y Respuesta
Las estructuras XML de solicitud y respuesta están definidas por la función Get de Fusion Lifecycle y la estructura del espacio de trabajo específico seleccionado como el objeto de la función Get. La estructura XML de solicitud está representada por un árbol de datos de los campos disponibles para identificar los elementos que recuperará la función Fusion Lifecycle Get. La estructura XML de respuesta está representada por un árbol de datos de campos disponibles dentro de los elementos solicitados para recuperar valores de datos.
-
El nombre de la función Get tiene como valor predeterminado "Fusion Lifecycle Get" más el nombre del espacio de trabajo seleccionado como objeto (artículos y listas de materiales (id:8) 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.
-
Haz clic en el icono 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 Get, Haga clic en uno de los Botones debajo de 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 Obtener y permite el acceso a los asistentes Crear solicitud y Crear respuesta desde el gráfico de flujo de trabajo.
-
Crear solicitud inicia el asistente de Transformación Crear solicitud.
-
Crear respuesta inicia el asistente de Transformación Crear respuesta.
Crear Asistente de Transformación de Solicitud
-
Haz clic en el botón Crear solicitud en la esquina superior derecha de la pestaña.
-
Aparecerá el cuadro de diálogo Asistente de Transformación.
-
El nombre de la Transformación de solicitud se establece automáticamente de forma predeterminada en "Fusion Lifecycle Get", además del nombre del objeto del espacio de trabajo seleccionado (Artículos y listas de materiales (id:8) en este ejemplo).
- Escriba el nombre apropiado en el campo Nombre en la esquina superior izquierda de la pantalla.
- Seleccione la fuente de los datos para la Solicitud de la lista desplegable.
- Para extraer datos directamente del espacio de trabajo de Fusion Lifecycle , 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.
- El objetivo se establece automáticamente de forma predeterminada en la función de conector Fusion Lifecycle Get y el objeto del espacio de trabajo (es decir, artículos y listas de materiales (id:8)) seleccionado en los pasos anteriores.
- En este ejemplo, solicitamos datos directamente desde el espacio de trabajo de Fusion Lifecycle y seleccionamos Ninguno para la fuente.
- Haz 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 Atrás.
-
Haga clic en el botón Cancelar para cerrar el asistente sin guardar sus entradas.
-
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, artículos y listas de materiales (id:8)) se muestran en la mitad derecha de la pantalla.
- Haga doble clic en el objetivo datos campo específico que se utilizará para la solicitud.
- Para este ejemplo, se seleccionó el campo Filtro Eliminado.
-
Formula Builder se muestra en la mitad izquierda de la pantalla.
-
Escriba la fórmula o el valor de datos en Formula Builder para solicitar elementos específicos del espacio de trabajo de Fusion Lifecycle.
- En este ejemplo, la función Fusion Lifecycle Get recuperará los elementos en los que el campo FilterDeleted se establece en un valor de True.
- 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 solicitud.
-
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.
-
Haz 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 implementa en el servidor de 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.
-
Haz 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 usa una fuente y la prueba solo muestra el valor ingresado en Formula Builder.
-
Si la Transformación de solicitud no se guardó ni implementó antes de la prueba, aparecerá el siguiente mensaje:
-
Haga clic en el botón Continuar en la parte inferior del mensaje emergente para desplegar la función Obtener 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.
-
El valor de los datos en el campo Objetivo seleccionado se muestra a la derecha del campo en el árbol de datos.
- Como se muestra en la Respuesta a continuació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 con el botón derecho para ir a una instancia arbitraria.
Crear Asistente de Transformación de Respuesta
- Haga clic en la pestaña Fusion Lifecycle Gets.
-
Haz clic en el botón Crear respuesta en la esquina superior derecha de la pestaña.
-
Se muestra el Asistente de Transformación.
-
El nombre de la Transformación de respuesta se establece automáticamente de forma predeterminada en "Fusion Lifecycle Get", además del nombre del objeto del espacio de trabajo seleccionado en los pasos anteriores (Artículos y listas de materiales (id:8) en este ejemplo).
- Escriba el nombre apropiado en el campo Nombre en la esquina superior izquierda de la pantalla.
- El origen se establece automáticamente de forma predeterminada en la función Fusion Lifecycle Get Connector y el objeto del espacio de trabajo seleccionado en los pasos anteriores (Artículos y listas de materiales (id:8) en este ejemplo).
- Seleccione el objetivo para los datos solicitados de la lista desplegable. Esto activa el botón Siguiente.
- En este ejemplo estamos enviando 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 de archivo.
- Para volver 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.
-
Seleccione un formato de archivo de la lista desplegable Definiciones de formatos de archivo disponibles.
-
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 en Finalizar para completar la definición del archivo y continuar creando la Transformación de respuesta.
- 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 llama Elementos de prueba y BOM.
-
Si está utilizando un archivo existente como modelo 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 cuadro de diálogo para crear un nuevo formato de archivo a partir de un archivo de modelo existente.
-
En este ejemplo, estamos creando el nuevo formato de archivo manualmente.
- Haga clic en el botón de opción correspondiente para seleccionar un archivo de texto simple o complejo.
- Haga clic en el botón de opción correspondiente para seleccionar anchos de campo fijos o delimitados por caracteres.
- Haga clic en el botón Crear manualmente para definir las 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.
- Escriba el nombre del campo en el cuadro Nombre del campo.
- El tipo de campo predeterminado es Cadena. Seleccione el tipo apropiado de la lista desplegable.
- 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 de Nombre y tipo de campo 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 Atrás.
-
Haga clic en el botón Cancelar para cerrar el asistente sin guardar sus entradas.
-
La estructura Fusion Lifecycle Get XML se muestra en la mitad izquierda de la pantalla como fuente de datos y el formato de 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 de origen que se asignarán al Destino.
-
Haga clic en el campo de datos deseado en la Fuente (columna izquierda).
- Arrastre y suelte el campo seleccionado en el campo apropiado en el Destino (columna derecha).
-
En este ejemplo, el valor del campo Número del Origen se asigna al campo Número en el archivo de texto Destino.
-
La asignación válida se indica con líneas verdes entre los elementos de las columnas Origen y Destino y, además, con la presencia de un cuadrado azul junto a cada nombre de campo asignado de forma válida.
- Una línea roja indica un mapeo no válido.
-
Una línea amarilla indica que Jitterbit no está seguro de si la asignación es válida, pero intentará la transformación con esta asignación.
-
Arrastre y suelte desde el Origen a la izquierda hasta el Destino a la derecha para completar la asignación en la pestaña Transformaciones. Cuando lo haga, una línea verde conectará cada elemento de origen y de destino, y aparecerá un cuadrado azul a la izquierda del elemento de origen y del elemento de destino.
- Para salir de esta pantalla, Haz clic en la X en la esquina superior derecha de la pestaña.
- Haz 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 implementa 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.
-
Haz 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 guardó ni implementó antes de la prueba, aparecerá el siguiente mensaje:
-
Haga clic en el botón Continuar en la parte inferior del mensaje emergente para desplegar la Transformación de respuesta.
-
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 unas a otras en función de eventos como Si se realiza correctamente o si falla, en función de condiciones definidas o en función de un cronograma.
-
Haga clic en la pestaña Fusion Lifecycle Gets.
-
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 de flujo de trabajo que representa la función Obtener del Fusion Lifecycle.
Pedido
-
Haga doble clic en el cuadro Solicitud en el cuadro 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 My Fusion Lifecycle Get Items and BOMs (id:8) – Request.
- 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.
- El nombre de la Solicitud seleccionada se muestra en el cuadro de flujo de trabajo Solicitud.
- En este ejemplo, se seleccionó My Fusion Lifecycle Get Items and BOMs (id:8) – Request. 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 la operación.
Respuesta
-
Haga doble clic en el cuadro Respuesta en el gráfico 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 My Fusion Lifecycle Get Items and BOMs (id:8) – Response.
- 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 la creación de Transformación de respuestas.
- El nombre de la respuesta seleccionada, My Fusion Lifecycle Get Items and BOMs(id:8) – Response, se muestra en el cuadro de flujo de trabajo de respuesta.
Objetivo
-
Haga doble clic en el cuadro Objetivo 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 cerrar la ventana.
-
Para crear un nuevo archivo, Haga clic en el botón Crear Nuevo objetivo para iniciar la pestaña Objetivos.
-
Escriba un nombre para el nuevo objetivo en el campo Nombre. En este ejemplo, el objetivo se denomina Elementos de obtención de prueba.
- 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.
- Haz clic en el botón Examinar. Busque y seleccione la carpeta adecuada.
- Escriba el nombre del archivo de destino en el cuadro Nombre del archivo. En este ejemplo, el nombre del archivo es Test Get Items.txt.
-
El nombre del objetivo, elementos de obtención de prueba, se muestra en el cuadro de flujo de trabajo de destino.
-
Haz 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 Get Items and BOMs(id:8) - Solicitud
- Respuesta: My Fusion Lifecycle Get Items and BOMs(id:8) – Response
- Objetivo: Prueba Obtener artículos.
- Haz 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 implementa en el servidor Jitterbit.
- Haz 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
-
Haz 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 a tamaño completo.
-
Haz clic en el ícono Operación de prueba que usa Transformación en la esquina inferior izquierda de la pantalla.
-
Todos los procesos de operación y los resultados se muestran en la columna Objetivo en la pantalla Respuesta.
-
Los datos de origen se transforman en función de las asignaciones de Transformación y los valores de destino se cargan en el árbol Objetivo. Los valores de datos de destino se muestran a la derecha del campo de destino en el árbol de datos.
- En este ejemplo, el campo FilterDeleted se estableció en True en 10 elementos. La operación recuperó con éxito los 10 artículos.
- Los valores múltiples se indican en el formato "1 de N" a la derecha de la carpeta Destino. En este ejemplo hay 10 valores.
- Haga clic en "1 de N" para alternar y ver los valores de los datos. En este ejemplo, se hizo clic dos veces en "1 de 10" para mostrar el 3erer conjunto de valores de 10. Puede presionar Mayús y hacer clic para ir a una instancia anterior o hacer clic con el botón derecho para ir a una instancia arbitraria.
- La operación también creó Test Get Items.txt que contiene los mismos resultados que se muestran en la pantalla Respuesta de Transformación.
Prueba de Operación
-
Haz clic en la pestaña Operaciones.
-
Haz clic en el Relámpago en la esquina superior derecha de la pantalla para colocar la operación en la cola de ejecución.
- El monitor de operación se muestra 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, tiempo de recepción, tiempo de inicio, tiempo de finalización y duración.
- Inicie un editor de texto y Abra Test Get Items.txt para ver los resultados de la operación.