Figma Módulos

Com os módulos do Adobe Workfront Fusion Figma, é possível 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 menu:

  • 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 licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.

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 básica
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 Adicionar 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
    Tipo de conexão

    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.

    Nome da Conexão Insira um nome para esta conexão.
    ID do Cliente Insira o Figme Client ID.
    Segredo do Cliente Insira 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 Continuar 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

Excluir um comentário

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

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

Listar comentários

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

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

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

  • Se você não souber a identificação, clique em Localizar Arquivos, insira ou mapeie a identificação do projeto ao qual o arquivo está associado e selecione o arquivo.

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

Número máximo de comentários retornados
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.

Postar um comentário

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

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

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

  • Se você não souber a identificação do arquivo, clique em Localizar Arquivos, insira ou mapeie a identificação 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 Localizar Projetos e insira ou mapeie a ID da equipe proprietária do projeto ao qual o arquivo está associado. Selecione o projeto e, em seguida, o arquivo.

Comentário
Insira o texto do comentário.

Projetos e arquivos

Obter um arquivo ou uma imagem

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

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

Selecione o tipo de objeto que deseja recuperar.

  • Arquivo

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

    Para campos, consulte Obter um arquivo ou imagem: Arquivo.

  • nós de Arquivo

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

    Para campos, consulte Obter um arquivo ou imagem: nós de arquivo.

  • Imagem

    O módulo renderiza imagens de um arquivo.

    Para campos, consulte Obter um arquivo ou imagem: Imagem.

  • Preenchimentos de imagem

    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 Obter um arquivo ou imagem: Preenchimentos de imagem.

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

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

Profundidade

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.

Geometria
Para retornar dados vetoriais, digite paths.
Dados do plug-in
Uma lista separada por vírgulas de IDs de plug-in e/ou a sequência "shared". Quaisquer dados presentes no documento escrito por esses plug-ins serão incluídos no resultado nas propriedades pluginData e sharedPluginData.
Dados de ramificação
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
Chave do arquivo
Selecione o arquivo do qual deseja retornar JSON.
IDs de Nó

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

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

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.

Geometria
Para retornar dados vetoriais, digite paths.
Dados do plug-in
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
Chave do arquivo
Selecione o arquivo do qual deseja retornar JSON.
IDs de Nó

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

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

Selecione o formato para a saída da imagem.

  • JPG

  • Imagem PNG

  • SVG

  • PDF

SVG - Incluir ID
Ative essa opção para incluir atributos de ID para todos os elementos do SVG. Padrão: false.
SVG - Simplificar Traço
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.
Usar limites absolutos
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.
Versão
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
Chave do arquivo
Selecione o arquivo do qual deseja retornar JSON.

Listar histórico de versões de arquivos

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

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

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 identificação do arquivo, clique em Localizar Arquivos, insira ou mapeie a identificação 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 Localizar Projetos e insira ou mapeie a ID da equipe proprietária do projeto ao qual o arquivo está associado. Selecione o projeto e, em seguida, o arquivo.

Número máximo de arquivos retornados
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.

Listar arquivos de projeto

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

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

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

  • Se você não souber a identificação dos projetos, clique em Localizar Projetos, insira ou mapeie a identificação da equipe à qual o projeto está associado e selecione o projeto.
Número máximo de arquivos retornados
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.

Listar projetos

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

Conexão
Para obter instruções sobre como conectar sua conta do Figma ao Workfront Fusion, consulte Criar uma conexão com o Figma neste artigo.
ID da Equipe
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
Número máximo de projetos retornados
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

Obter um estilo ou componente

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

Conexão
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.
<Objeto> chave
Informe a chave (identificador exclusivo) do objeto que deseja recuperar.
ID da Equipe
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.
Tamanho da Página
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.
Depois

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 Tamanho da página 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 Antes.

Antes

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 Tamanho da página 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.

Outras

Fazer uma chamada de API

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.

Conexão
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

Método
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.
Cabeçalhos

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

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

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

Cadeia de Consulta

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

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

Corpo

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

Observação:

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

Assistir a eventos

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 Adicionar 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 Salvar para salvar o webhook e retornar ao módulo.

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