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 Criar um cenário.

Para obter informações sobre módulos, consulte Módulos em Adobe Workfront Fusion.

Requisitos de acesso

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

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plano, Trabalho
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o plano Select ou Prime Adobe Workfront, sua organização deve comprar Adobe Workfront Fusion e Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

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

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 em Adobe Workfront Fusion.

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 Adobe Workfront Fusion - Instruções básicas.
ID de Arquivo
Insira ou mapeie a ID do arquivo do qual você deseja adicionar um comentário para exclusão.
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 Adobe Workfront Fusion - Instruções básicas.
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.

Limite
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 Adobe Workfront Fusion - Instruções básicas.
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 Adobe Workfront Fusion - Instruções básicas.
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 uma 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 uma 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
Habilite esta opção para incluir atributos de ID para todos os elementos de 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.
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.
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 Adobe Workfront Fusion - Instruções básicas.
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.

Limite
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 Adobe Workfront Fusion - Instruções básicas.
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.
Limite
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 Adobe Workfront Fusion - Instruções básicas.
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
Limite
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 Adobe Workfront Fusion - Instruções básicas.
<Objeto> chave
Informe a chave (identificador exclusivo) do objeto que deseja recuperar.
ID da Equipe
Insira ou mapeie a ID da equipe à qual o registro ou os registros estão associados.
Tamanho da Página
Insira ou mapeie o número ou os resultados a serem retornados por página. Padrão: 30.
Depois

Insira ou mapeie o número do resultado após o qual 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

Insira ou mapeie o número do resultado antes do qual 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.

Outro

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 Adobe Workfront Fusion - Instruções básicas.
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 em Adobe Workfront Fusion.
Cabeçalhos

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

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.

Nota:

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 acionamento inicia um cenário quando um dos seguintes eventos ocorre para uma equipe específica no seu espaço de equipe 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. 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.

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

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

  5. Insira o Status ou a Descrição dos eventos que você deseja que o webhook assista.

  6. Clique em Salvar para salvar o webhook e retornar ao módulo.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43