Figma Módulos

Com os módulos Adobe Workfront Fusion Figma, você pode recuperar listas de comentários, arquivos, versões de arquivos ou projetos. Você também pode postar um comentário ou chamar a API Figma.

Se você precisar de instruções sobre como criar um cenário, consulte os artigos em Criar um cenário: índice do artigo.

Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion.

Ou

Herdados: Automação e integração do Workfront Fusion for Work

Produto

Novo:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.

Pré-requisitos

Para usar módulos Figma, você deve ter uma conta Figma.

Informações da API do Figma

O conector Figma usa o seguinte:

URL base
https://api.figma.com/v1
Versão da API
v1
Tag da API
v1.8.25

Criar uma conexão com Figma

Para criar uma conexão para os módulos do Figma:

  1. Em qualquer módulo Figma, clique em Add ao lado da caixa Conexão.

  2. Preencha os seguintes campos:

    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 novas conexões, selecione Figma sem a marca Herdada.

    O Figma alterou seus requisitos de autenticação em janeiro de 2025. O tipo de conexão Figma atende aos novos requisitos. O tipo de conexão Figma (Legacy) será removido no futuro.

    Connection name Insira um nome para esta conexão.
    Client ID Insira seu Figme Client ID.
    Client Secret Digite seu Figma Client Secret.
    Escopos personalizados Insira os escopos personalizados necessários para esta conexão.
    URL de Verificação de Conexão Personalizada O ponto de extremidade padrão para verificar se a conexão foi criada com êxito é: https://api.figma.com/v1/me Se esta URL não tiver suporte para o Escopo Personalizado, forneça uma URL de Verificação personalizada.
  3. Clique em Continue para salvar a conexão e retornar ao módulo.

Figma módulos e seus campos

Ao configurar módulos do Figma, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos Figma adicionais podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Alternância de mapa

Comentários

Delete a comment

Este módulo de ação exclui um único comentário de um arquivo.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
File ID
Insira ou mapeie a ID do arquivo do qual você deseja adicionar um comentário para exclusão.
Comment ID
Insira o texto do comentário que deseja excluir.

List comments

Este módulo de pesquisa lista todos os comentários anexados a um único arquivo no Figma.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
File ID

Insira ou mapeie a ID do arquivo para o qual deseja recuperar comentários.

  • Caso não saiba a ID, clique em Find Files, insira ou mapeie a ID do projeto ao qual o arquivo está associado e selecione o arquivo.

  • Se você não souber a ID do projeto, clique em Find Projects, insira ou mapeie a ID da equipe que possui o projeto ao qual o arquivo está associado, selecione o projeto e selecione o arquivo.

Maximum number of returned comments
Insira ou mapeie o número máximo de comentários que você deseja que o módulo retorne durante cada ciclo de execução de cenário.

Post a comment

Este módulo de ação publica um comentário em um arquivo Figma.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
File ID

Insira ou mapeie a ID do arquivo no qual você deseja postar um comentário.

  • Se você não souber a ID do arquivo, clique em Find Files, insira ou mapeie a ID do projeto ao qual o arquivo está associado e selecione o arquivo.

  • Se você estiver tentando encontrar a ID do arquivo e não souber a ID do projeto, clique em Find Projects e insira ou mapeie a ID da equipe que possui o projeto ao qual o arquivo está associado. Selecione o projeto e, em seguida, o arquivo.

Comment
Insira o texto do comentário.

Projetos e arquivos

Get a file or image

Este módulo de ação recupera um único arquivo ou imagem de uma biblioteca Figma

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
Object type

Selecione o tipo de objeto que deseja recuperar.

  • File

    O módulo retorna o documento referenciado por Key como um objeto JSON. A chave do arquivo pode ser analisada de qualquer URL do arquivo Figma.

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

  • File nodes

    Retorna os nós aos quais as IDs fazem referência como um objeto JSON. Os nós são recuperados do arquivo Figma referenciado por Key.

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

  • Image

    O módulo renderiza imagens de um arquivo.

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

  • Image fills

    O módulo retorna links de download para todas as imagens presentes em preenchimentos de imagem em um documento. Os preenchimentos de imagem são como Figma representa quaisquer imagens fornecidas pelo usuário. Quando você arrasta uma imagem para Figma, Figma cria um retângulo com um único preenchimento que representa a imagem, e o usuário pode transformar o retângulo (e as propriedades no preenchimento).

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

Obter um arquivo ou imagem: Arquivo
File key
Selecione o arquivo do qual deseja retornar JSON.
Version ID
Insira ou mapeie a versão do arquivo que o módulo deve retornar. Para o módulo atual, deixe este campo em branco.
Node IDs

Para retornar apenas um subconjunto do documento, insira os nós que você deseja que o módulo retorne. O módulo retorna os nós listados, seus filhos e qualquer item entre o nó raiz e os nós listados.

Para cada nó que você deseja retornar, clique em Add e insira o texto do nó.

Depth

Insira ou mapeie um número inteiro que represente a profundidade máxima na árvore de documentos para a qual você deseja retornar resultados.

Exemplo:

  • Para retornar somente páginas, digite 1.

  • Para retornar páginas e objetos de nível superior, digite 2.

Para retornar todos os nós, deixe este campo em branco.

Geometry
Para retornar dados vetoriais, digite paths.
Plugin data
Uma lista separada por vírgulas de IDs de plug-in e/ou a sequência de caracteres "shared". Quaisquer dados presentes no documento escrito por esses plug-ins serão incluídos no resultado nas propriedades pluginData e sharedPluginData.
Branch data
Habilite esta opção para retornar os metadados da ramificação para o arquivo solicitado. Se o arquivo for uma ramificação, a chave do arquivo principal será incluída na resposta retornada. Se o arquivo tiver ramificações, os metadados serão incluídos na resposta retornada. Padrão: false.
Obter um arquivo ou imagem: nós de arquivo
File key
Selecione o arquivo do qual deseja retornar JSON.
Node IDs

Insira os nós que você deseja que o módulo retorne e converta

Para cada nó que você deseja retornar, clique em Add e insira o texto do nó.

Version ID
Insira ou mapeie a versão do arquivo que o módulo deve retornar. Para o módulo atual, deixe este campo em branco.
Depth

Insira ou mapeie um número inteiro que represente a profundidade máxima na árvore de documentos para a qual você deseja retornar resultados.

Exemplo:

  • Para retornar somente páginas, digite 1.

  • Para retornar páginas e objetos de nível superior, digite 2.

Para retornar todos os nós, deixe este campo em branco.

Geometry
Para retornar dados vetoriais, digite paths.
Plugin data
Uma lista separada por vírgulas de IDs de plug-in e/ou a sequência "compartilhada". Quaisquer dados presentes no documento escrito por esses plug-ins serão incluídos no resultado nas propriedades pluginData e sharedPluginData.
Obter um arquivo ou imagem: Imagem
File key
Selecione o arquivo do qual deseja retornar JSON.
Node IDs

Insira os nós que você deseja que o módulo renderize.

Para cada nó que você deseja renderizar, clique em Add e insira o texto do nó.

Scale
Para dimensionar a imagem, insira ou mapeie o fator de dimensionamento. Este número deve estar entre 0,01 e 4.
Format

Selecione o formato para a saída da imagem.

  • JPG

  • Imagem PNG

  • SVG

  • PDF

SVG - Include ID
Habilite esta opção para incluir atributos de ID para todos os elementos de SVG. Padrão: false.
SVG - Simplify Stroke
Ative essa opção para simplificar traçados internos/externos e, se possível, use o atributo de traçado em vez de <mask>. Padrão: true.
Use absolute bounds
Habilite essa opção para usar as dimensões completas do nó, independentemente de ele estar ou não cortado ou do espaço ao redor estar vazio. Use isso para exportar nós de texto sem cortar. Padrão: false.
Version
Insira ou mapeie a versão do arquivo que o módulo deve retornar. Para o módulo atual, deixe este campo em branco.
Obter um arquivo ou imagem: preenchimentos de imagem
File key
Selecione o arquivo do qual deseja retornar JSON.

List file version history

Este módulo de pesquisa retorna o histórico de versões de um único arquivo em Figma.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
File ID

Insira ou mapeie a ID do arquivo para o qual você deseja recuperar o histórico de versões.

  • Se você não souber a ID do arquivo, clique em Find Files, insira ou mapeie a ID do projeto ao qual o arquivo está associado e selecione o arquivo.

  • Se você estiver tentando encontrar a ID do arquivo e não souber a ID do projeto, clique em Find Projects e insira ou mapeie a ID da equipe que possui o projeto ao qual o arquivo está associado. Selecione o projeto e, em seguida, o arquivo.

Maximum number of returned files
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

List project files

Este módulo de pesquisa retorna uma lista de todos os arquivos no projeto especificado.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
File ID

Insira ou mapeie a ID do projeto para o qual você deseja recuperar os arquivos.

  • Se você não souber a ID do projeto, clique em Find Projects, insira ou mapeie a ID da equipe à qual o projeto está associado e selecione o projeto.
Maximum number of returned files
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

List projects

Este módulo de pesquisa retorna uma lista de todos os projetos dentro da equipe especificada.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
Team ID
Insira ou mapeie a ID do projeto do qual você deseja recuperar os arquivos. A ID da equipe pode ser encontrada no URL da página da equipe no Figma
Maximum number of returned projects
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Componentes e estilos

Get a style or component

Este módulo de ação recupera um único estilo ou componente, ou um conjunto de estilos ou componentes.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
Objeto> tipo
Selecione o tipo de objeto que deseja recuperar.
<Object> key
Informe a chave (identificador exclusivo) do objeto que deseja recuperar.
Team ID
Se estiver recuperando um componente de equipe ou conjunto de componentes de equipe, digite ou mapeie a ID da equipe à qual o registro ou os registros estão associados.
Page Size
Se estiver recuperando um componente de grupo ou conjunto de componentes de grupo, digite ou mapeie o número ou os resultados a serem retornados por página. Padrão: 30.
After

Se estiver recuperando um componente de grupo ou conjunto de componentes de grupo, digite ou mapeie o número do resultado após o qual deve começar a recuperar os resultados. Isso pode ser combinado com o campo Page Size para paginar resultados.

Esse valor não corresponde às IDs de objeto.

Este campo não pode ser usado em combinação com o campo Before.

Before

Se estiver recuperando um componente de grupo ou conjunto de componentes de grupo, digite ou mapeie o número do resultado antes de começar a recuperar os resultados. Isso pode ser combinado com o campo Page Size para paginar resultados.

Esse valor não corresponde às IDs de objeto.

Este campo não pode ser usado em combinação com o campo After.

Outro

Make an API call

Esse módulo de ação permite fazer uma chamada autenticada personalizada para a API Figma sem precisar pensar na autenticação. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Figma.

Connection
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
URL

Insira um caminho relativo para https://api.figma.com/v1/.

Por exemplo: files/7179110/comments

Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

Workfront Fusion O adiciona os cabeçalhos de autorização para você.

Query String

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

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

Body

Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.

Nota:

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Watch events

Este módulo de acionador inicia um cenário quando um dos seguintes eventos ocorre para uma equipe específica no espaço de equipe do Figma:

  • Atualização de arquivo

  • Atualização da versão do arquivo

  • Arquivo excluir

  • Publicação da biblioteca

  • Comentário do arquivo

Webhook

Selecione o webhook que o módulo observa.

Para adicionar um novo webhook:

  1. Clique em Add ao lado do campo Webhook.

  2. Insira um nome para o webhook.

  3. Selecione a conexão que deseja usar com este webhook. Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.

  4. Selecione o tipo de evento que você deseja que o módulo veja.

  5. Digite a ID da equipe cujos eventos você deseja que o webhook assista.

  6. Selecione se deseja que o webhook fique ativo ou pausado.

  7. Insira uma descrição para o webhook.

  8. Clique em Save para salvar o webhook e retornar ao módulo.

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