Módulos de Figma

Con los módulos Adobe Workfront Fusion Figma, puede recuperar listas de comentarios, archivos, versiones de archivos o proyectos. También puede publicar un comentario o llamar a la API Figma.

Si necesita instrucciones sobre cómo crear un escenario, vea los artículos en Crear un escenario: índice de artículos.

Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
paquete de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: Trabajo o superior

Licencia de Adobe Workfront Fusion**

Actual: no se requiere licencia de Workfront Fusion.

O

Heredado: Workfront Fusion para la automatización e integración del trabajo

Producto

Nuevo:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

O

Actual: Su organización debe adquirir Adobe Workfront Fusion.

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.

Requisitos previos

Para usar módulos Figma, debe tener una cuenta de Figma.

Información de API de Figma

El conector Figma utiliza lo siguiente:

URL básica
https://api.figma.com/v1
Versión de API
Versión 1
Etiqueta de API
Versión 1.8.25

Crear una conexión con Figma

Para crear una conexión para los módulos Figma:

  1. En cualquier módulo Figma, haga clic en Add junto al cuadro Conexión.

  2. Rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection type

    Para nuevas conexiones, seleccione Figma sin la etiqueta Heredado.

    Figma cambió sus requisitos de autenticación en enero de 2025. El tipo de conexión Figma cumple los nuevos requisitos. El tipo de conexión Figma (Legacy) se eliminará en el futuro.

    Connection name Introduzca un nombre para esta conexión.
    Client ID Escriba su Figme Client ID.
    Client Secret Escriba su Figma Client Secret.
    Ámbitos personalizados Escriba los ámbitos personalizados necesarios para esta conexión.
    URL de verificación de conexión personalizada El extremo predeterminado para comprobar que la conexión se creó correctamente es: https://api.figma.com/v1/me. Si esta dirección URL no es compatible con el ámbito personalizado, proporcione una dirección URL de verificación personalizada.
  3. Haga clic en Continue para guardar la conexión y volver al módulo.

Módulos de Figma y sus campos

Al configurar módulos de Figma, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Figma campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.

Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.

Conmutador Asignar

Comentarios

Delete a comment

Este módulo de acción elimina un solo comentario de un archivo.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
File ID
Introduzca o asigne el ID de archivo del archivo desde el que desea agregar o eliminar un comentario.
Comment ID
Escriba el texto del comentario que desea eliminar.

List comments

Este módulo de búsqueda enumera todos los comentarios adjuntos a un solo archivo en Figma.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
File ID

Introduzca o asigne el ID de archivo del archivo para el que desea recuperar los comentarios.

  • Si no conoce el identificador, haga clic en Find Files, escriba o asigne el identificador del proyecto al que está asociado el archivo y, a continuación, seleccione el archivo.

  • Si no conoce el identificador del proyecto, haga clic en Find Projects, escriba o asigne el identificador del equipo propietario del proyecto con el que está asociado el archivo, seleccione el proyecto y, a continuación, seleccione el archivo.

Maximum number of returned comments
Introduzca o asigne el número máximo de comentarios que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

Post a comment

Este módulo de acción publica un comentario en un archivo Figma.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
File ID

Introduzca o asigne el ID de archivo del archivo en el que desea publicar un comentario.

  • Si no conoce el identificador del archivo, haga clic en Find Files, escriba o asigne el identificador del proyecto al que está asociado el archivo y, a continuación, seleccione el archivo.

  • Si está intentando encontrar el identificador del archivo y no conoce el identificador del proyecto, haga clic en Find Projects y escriba o asigne el identificador del equipo propietario del proyecto con el que está asociado el archivo. Seleccione el proyecto y, a continuación, seleccione el archivo.

Comment
Introduzca el texto del comentario.

Proyectos y archivos

Get a file or image

Este módulo de acción recupera un solo archivo o imagen de una biblioteca Figma

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
Object type

Seleccione el tipo de objeto que desea recuperar.

  • File

    El módulo devuelve el documento al que hace referencia Key como objeto JSON. La clave del archivo se puede analizar desde cualquier URL del archivo Figma.

    Para ver los campos, consulte Get a file or image: File.

  • File nodes

    Devuelve los nodos a los que hacen referencia los identificadores como un objeto JSON. Los nodos se recuperan del archivo Figma al que hace referencia Key.

    Para ver los campos, consulte Get a file or image: File nodes.

  • Image

    El módulo procesa imágenes de un archivo.

    Para ver los campos, consulte Get a file or image: Image.

  • Image fills

    El módulo devuelve vínculos de descarga para todas las imágenes presentes en los rellenos de imagen de un documento. Los rellenos de imagen muestran Figma las imágenes que proporcionó el usuario. Cuando arrastra una imagen a Figma, Figma crea un rectángulo con un solo relleno que representa la imagen y el usuario puede transformar el rectángulo (y las propiedades del relleno).

    Para ver los campos, consulte Get a file or image: Image fills.

Obtener un archivo o imagen: Archivo
File key
Seleccione el archivo desde el que desea devolver JSON.
Version ID
Introduzca o asigne la versión del archivo que desea que devuelva el módulo. Para el módulo actual, deje este campo en blanco.
Node IDs

Para devolver sólo un subconjunto del documento, escriba los nodos que desea que devuelva el módulo. El módulo devuelve los nodos enumerados, sus nodos secundarios y cualquier elemento entre el nodo raíz y los nodos enumerados.

Para cada nodo que desee devolver, haga clic en Add e introduzca el texto del nodo.

Depth

Introduzca o asigne un entero que represente la profundidad en el árbol de documentos para la que desea devolver resultados.

Ejemplo:

  • Para devolver solo las páginas, escriba 1.

  • Para devolver páginas y objetos de nivel superior, escriba 2.

Para devolver todos los nodos, deje este campo en blanco.

Geometry
Para devolver datos vectoriales, escriba paths.
Plugin data
Lista separada por comas de los identificadores de complemento o de la cadena "shared". Cualquier dato presente en el documento escrito por esos complementos se incluirá en el resultado en las propiedades pluginData y sharedPluginData.
Branch data
Active esta opción para devolver los metadatos de la rama del archivo solicitado. Si el archivo es una rama, la clave del archivo principal se incluye en la respuesta devuelta. Si el archivo tiene ramas, sus metadatos se incluyen en la respuesta devuelta. Predeterminado: false.
Obtener un archivo o imagen: nodos de archivo
File key
Seleccione el archivo desde el que desea devolver JSON.
Node IDs

Introduzca los nodos que desea que devuelva y convierta el módulo

Para cada nodo que desee devolver, haga clic en Add e introduzca el texto del nodo.

Version ID
Introduzca o asigne la versión del archivo que desea que devuelva el módulo. Para el módulo actual, deje este campo en blanco.
Depth

Introduzca o asigne un entero que represente la profundidad en el árbol de documentos para la que desea devolver resultados.

Ejemplo:

  • Para devolver solo las páginas, escriba 1.

  • Para devolver páginas y objetos de nivel superior, escriba 2.

Para devolver todos los nodos, deje este campo en blanco.

Geometry
Para devolver datos vectoriales, escriba paths.
Plugin data
Una lista separada por comas de los ID de complemento o la cadena "compartida". Los datos presentes en el documento escrito por esos complementos se incluirán en el resultado de las propiedades pluginData y sharedPluginData.
Obtener un archivo o imagen: Imagen
File key
Seleccione el archivo desde el que desea devolver JSON.
Node IDs

Introduzca los nodos que desea que procese el módulo.

Para cada nodo que desee procesar, haga clic en Add e introduzca el texto del nodo.

Scale
Para escalar la imagen, introduzca o asigne el factor de escala. Este número debe estar entre 0,01 y 4.
Format

Seleccione el formato para la salida de imagen.

  • JPG

  • PNG

  • SVG

  • PDF

SVG - Include ID
Active esta opción para incluir los atributos de ID de todos los elementos del SVG. Predeterminado: false.
SVG - Simplify Stroke
Active esta opción para simplificar los trazos interiores/exteriores y utilice el atributo de trazo si es posible en lugar de <máscara>. Predeterminado: true.
Use absolute bounds
Active esta opción para utilizar las dimensiones completas del nodo independientemente de si se recorta o no o el espacio alrededor está vacío. Utilice esta opción para exportar nodos de texto sin recortarlos. Predeterminado: false.
Version
Introduzca o asigne la versión del archivo que desea que devuelva el módulo. Para el módulo actual, deje este campo en blanco.
Obtener un archivo o imagen: rellenos de imagen
File key
Seleccione el archivo desde el que desea devolver JSON.

List file version history

Este módulo de búsqueda devuelve el historial de versiones de un solo archivo en Figma.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
File ID

Introduzca o asigne el ID de archivo del archivo para el que desea recuperar el historial de versiones.

  • Si no conoce el identificador del archivo, haga clic en Find Files, escriba o asigne el identificador del proyecto al que está asociado el archivo y, a continuación, seleccione el archivo.

  • Si está intentando encontrar el identificador del archivo y no conoce el identificador del proyecto, haga clic en Find Projects y escriba o asigne el identificador del equipo propietario del proyecto con el que está asociado el archivo. Seleccione el proyecto y, a continuación, seleccione el archivo.

Maximum number of returned files
Introduzca o asigne el número máximo de registros que desea que el módulo devuelva durante cada ciclo de ejecución de escenario.

List project files

Este módulo de búsqueda devuelve una lista de todos los archivos del proyecto especificado.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
File ID

Escriba o asigne el Id. del proyecto para el que desea recuperar los archivos.

  • Si no conoce el identificador del proyecto, haga clic en Find Projects, escriba o asigne el identificador del equipo con el que está asociado el proyecto y, a continuación, seleccione el proyecto.
Maximum number of returned files
Introduzca o asigne el número máximo de registros que desea que el módulo devuelva durante cada ciclo de ejecución de escenario.

List projects

Este módulo de búsqueda devuelve una lista de todos los proyectos dentro del equipo especificado.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
Team ID
Escriba o asigne el Id. del proyecto para el que desea recuperar los archivos. El ID del equipo se puede encontrar en la dirección URL de la página del equipo en Figma
Maximum number of returned projects
Introduzca o asigne el número máximo de registros que desea que el módulo devuelva durante cada ciclo de ejecución de escenario.

Componentes y estilos

Get a style or component

Este módulo de acción recupera un solo estilo o componente, o un conjunto de estilos o componentes.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
Object> type
Seleccione el tipo de objeto que desea recuperar.
<Object> key
Introduzca la clave (identificador único) del objeto que desea recuperar.
Team ID
Si recupera un componente del equipo o un conjunto de componentes del equipo, introduzca o asigne el ID del equipo al que están asociados el registro o registros.
Page Size
Si recupera un componente del equipo o un conjunto de componentes del equipo, introduzca o asigne el número o los resultados que se devolverán por página. Predeterminado: 30.
After

Si recupera un componente del equipo o un conjunto de componentes del equipo, introduzca o asigne el número del resultado después del cual se comenzará a recuperar los resultados. Esto se puede combinar con el campo Page Size para paginar los resultados.

Este valor no se corresponde con los ID de objeto.

Este campo no se puede usar en combinación con el campo Before.

Before

Si recupera un componente del equipo o un conjunto de componentes del equipo, introduzca o asigne el número del resultado antes del cual se debe iniciar la recuperación de resultados. Esto se puede combinar con el campo Page Size para paginar los resultados.

Este valor no se corresponde con los ID de objeto.

Este campo no se puede usar en combinación con el campo After.

Otro

Make an API call

Este módulo de acción le permite realizar una llamada autenticada personalizada a la API de Figma sin tener que pensar en la autenticación. De este modo, puede crear una automatización del flujo de datos que no se puede lograr con los otros módulos Figma.

Connection
Para obtener instrucciones sobre cómo conectar tu cuenta de Figma a Workfront Fusion, consulta Crear una conexión con Figma en este artículo.
URL

Escriba una ruta relativa a https://api.figma.com/v1/.

Por ejemplo: files/7179110/comments

Method
Seleccione el método de petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, vea Métodos de solicitud HTTP.
Headers

Añada los encabezados de la solicitud en forma de objeto JSON estándar.

Por ejemplo: {"Content-type":"application/json"}

Workfront Fusion añade los encabezados de autorización automáticamente.

Query String

Añada la consulta para la llamada de API en forma de objeto JSON estándar.

Por ejemplo: {"name":"something-urgent"}

Body

Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Watch events

Este módulo de déclencheur inicia un escenario cuando se produce uno de los siguientes eventos para un equipo específico en el espacio de equipo Figma:

  • Actualización de archivo

  • Actualización de versión de archivo

  • Eliminar archivo

  • Publicación de biblioteca

  • Comentario de archivo

Webhook

Seleccione el webhook que ve el módulo.

Para añadir un nuevo webhook:

  1. Haga clic en Add junto al campo Webhook.

  2. Introduzca un nombre para el webhook.

  3. Seleccione la conexión que desea utilizar para este webhook. Para obtener instrucciones acerca de cómo conectar su cuenta de Figma a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.

  4. Seleccione el tipo de evento que desea que vea el módulo.

  5. Introduzca el ID del equipo cuyos eventos desea que vea el webhook.

  6. Seleccione si desea que el webhook esté activo o en pausa.

  7. Escriba una descripción para el webhook.

  8. Haga clic en Save para guardar el webhook y volver al módulo.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3