Frame.io módulos

Os módulos do Adobe Workfront Fusion Frame.io permitem monitorar, criar, atualizar, recuperar ou excluir ativos e comentários em sua conta do Frame.io.

Para obter uma introdução ao vídeo sobre o conector Frame.io, consulte:

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 Frame.io, você deve ter uma conta Frame.io

Informações da API do Frame.io

O conector Frame.io usa o seguinte:

URL base
https://api.frame.io/v2
Versão da API
v2
Tag da API
v1.0.76

Conectar Frame.io ao Adobe Workfront Fusion

Você pode se conectar a Frame.io usando um token de API ou usando o OAuth 2.0.

Conectar-se ao Frame.io usando um token de API

Conectar-se ao Frame.io usando o PKCE do OAuth 2.0

Conectar-se a Frame.io usando um token de API

Para conectar sua conta do Frame.io ao Workfront Fusion usando um token de API, você deve criar o token de API em sua conta do Frame.io e inseri-lo na caixa de diálogo Workfront Fusion Frame.io Criar uma conexão.

  1. Faça logon em sua conta do Frame.io.
  2. Vá para a página Tokens no Frame.io Developer.
  3. Clique em Novo.
  4. Insira o nome do token, selecione os escopos que deseja usar e clique em Criar.
  5. Copie o token fornecido.
  6. Vá para Workfront Fusion e abra a caixa de diálogo Criar uma conexão do módulo Frame.io.
  7. No campo Tipo de conexão, selecione Frame.io.
  8. Insira o token que você copiou na etapa 5 para o campo Sua Frame.io Chave de API e clique em Continuar para estabelecer a conexão.

A conexão foi estabelecida. Você pode prosseguir com a configuração do módulo.

Conectar a Frame.io usando o PKCE do OAuth 2.0

Você pode criar uma conexão com Frame.io usando o PKCE OAuth 2.0 com uma ID de cliente opcional. Para incluir uma ID do cliente em sua conexão, crie um aplicativo OAuth 2.0 na conta Frame.io.

Conecte-se a Frame.io usando o PKCE do OAuth 2.0 (sem ID do cliente)

  1. Vá para Workfront Fusion e abra a caixa de diálogo Criar uma conexão do módulo Frame.io.
  2. No campo Tipo de conexão, selecione Frame.ioPKCE OAuth 2.0.
  3. Insira um nome para a nova conexão no campo Nome da conexão.
  4. Clique em Continuar para estabelecer a conexão.

A conexão foi estabelecida. Você pode prosseguir com a configuração do módulo.

Conecte-se a Frame.io usando o PKCE do OAuth 2.0 (com ID de Cliente)

  1. Crie um aplicativo OAuth 2.0 em Frame.io. Para obter instruções, consulte a documentação do Frame.io em Fluxo de Autorização de Código do OAuth 2.0.

    note important
    IMPORTANT
    Ao criar o aplicativo OAuth 2.0 em Frame.io:
    • Insira o seguinte como o URI de redirecionamento:

      Américas / APAC https://app.workfrontfusion.com/oauth/cb/frame-io5

      EMEA https://app-eu.workfrontfusion.com/oauth/cb/frame-io5

    • Ative a opção PCKE.

  2. Copie o client_id fornecido.

  3. Vá para Workfront Fusion e abra a caixa de diálogo Criar uma conexão do módulo Frame.io.

  4. No campo Tipo de conexão, selecione Frame.ioPKCE OAuth 2.0.

  5. Insira um nome para a nova conexão no campo Nome da conexão.

  6. Clique em Mostrar configurações avançadas.

  7. Insira o client_id copiado na etapa 2 para o campo ID do cliente.

  8. Clique em Continuar para estabelecer a conexão.

A conexão foi estabelecida. Você pode prosseguir com a configuração do módulo.

Frame.io módulos e seus campos

Ao configurar módulos do Frame.io, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos Frame.io 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.

Ativos

Criar um ativo

Este módulo de ação cria um novo ativo.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto para o qual você deseja criar um ativo.
ID de Projeto
Selecione o projeto ou mapeie a ID do projeto para o qual você deseja criar um ativo.
ID da Pasta
Selecione a pasta ou mapeie a ID da pasta na qual deseja criar um ativo.
Tipo
Selecione se deseja criar uma pasta ou um arquivo.
Nome
Insira o nome do novo arquivo ou pasta.
URL DO Source
Insira o URL do arquivo que você deseja fazer upload.
Descrição
Insira uma breve descrição do ativo.

Excluir um ativo

Esse módulo de ação exclui um ativo especificado.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe que possui o projeto que contém o ativo que você deseja excluir.
ID de Projeto
Selecione o projeto ou que contém o ativo que você deseja excluir.
ID da Pasta
Selecione a pasta que contém o ativo que você deseja excluir
ID de Ativo
Selecione ou mapeie o ativo que deseja excluir.

Obter um ativo

Este módulo de ação recupera detalhes do ativo.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém o ativo sobre o qual você deseja recuperar detalhes.
ID de Projeto
Selecione o projeto que contém o ativo do qual deseja recuperar detalhes.
ID da Pasta
Selecione a pasta que contém o ativo do qual deseja recuperar detalhes.
ID de Ativo
Selecione o ativo ou mapeie a ID do ativo sobre o qual deseja recuperar detalhes.

Listar Assets

Este módulo de pesquisa recupera todos os ativos na pasta do projeto especificado.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém a pasta da qual você deseja recuperar ativos.
ID de Projeto
Selecione o projeto que contém a pasta da qual deseja recuperar ativos.
ID da Pasta
Selecione a pasta da qual deseja listar ativos.
Limite
Defina o número máximo de ativos que Workfront Fusion retornará durante um ciclo de execução.

Update an Asset

Esse módulo de ação permite atualizar o nome, a descrição ou os campos personalizados de um ativo existente.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto para o qual você deseja atualizar um ativo.
ID de Projeto
Selecione o projeto ou mapeie a ID do projeto para o qual você deseja atualizar um ativo.
ID da Pasta
Selecione a pasta ou mapeie a ID da pasta na qual deseja atualizar um ativo.
Nome
Insira o nome do arquivo atualizado.
Descrição
Insira uma breve descrição do ativo atualizado.

Ativo de observação excluído

Este módulo de acionamento inicia um cenário quando um ativo é excluído.

Nome do Webhook
Insira o nome do webhook, por exemplo, Ativo excluído.
Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione a equipe para a qual este webhook foi criado.

Rótulo do ativo de observação atualizado

Esse módulo de acionamento inicia um cenário quando o status de um ativo é definido, alterado ou removido.

Nome do Webhook
Insira o nome do webhook, por exemplo, Status do ativo atualizado.
Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione a equipe para a qual este webhook foi criado.

Assista ao novo ativo

Esse módulo de acionador inicia um cenário quando um novo ativo é criado.

Nome do Webhook
Insira o nome do webhook, por exemplo, Asset created.
Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione a equipe para a qual este webhook foi criado.

Comentários

Criar um comentário

Esse módulo de ação adiciona um novo comentário ou resposta ao ativo.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
Tipo
Selecione se deseja criar um comentário ou responder a um comentário.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém o ativo ao qual você deseja adicionar um comentário.
ID de Projeto
Selecione o projeto ou mapeie a ID do projeto que contém o ativo ao qual você deseja adicionar um comentário.
ID da Pasta
Selecione a pasta ou mapeie a ID da pasta que contém o ativo ao qual você deseja adicionar um comentário.
ID de Ativo
Selecione ou mapeie o ativo ao qual deseja adicionar um comentário.
ID de Comentário
Selecione ou mapeie o comentário ao qual deseja adicionar uma resposta.
Texto
Insira o conteúdo do texto do comentário ou da resposta.
Carimbo de Data/Hora
Insira o número do quadro no vídeo ao qual o comentário deve ser vinculado.

Excluir um comentário

Este módulo de ação exclui um comentário existente.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém o ativo do qual você deseja excluir um comentário.
ID de Projeto
Selecione o projeto ou mapeie a ID do projeto que contém o ativo do qual você deseja excluir um comentário.
ID da Pasta
Selecione a pasta que contém o ativo do qual você deseja excluir um comentário.
ID de Ativo
Selecione o ativo que contém o comentário que deseja excluir.
ID de Comentário
Selecione o comentário que deseja excluir.

Obter um comentário

Este módulo de ação recupera detalhes do comentário especificado.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém a pasta da qual você deseja recuperar ativos.
ID de Projeto
Selecione o projeto que contém a pasta da qual deseja recuperar ativos.
ID da Pasta
Selecione a pasta da qual deseja listar ativos.
ID de Ativo
Selecione o ativo que contém o comentário que você deseja recuperar.
ID de Comentário
Selecione o comentário sobre o qual deseja recuperar detalhes.

Listar comentários

Este módulo de pesquisa recupera todos os comentários do ativo especificado.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém a pasta da qual você deseja recuperar comentários.
ID de Projeto
Selecione o projeto que contém a pasta da qual deseja recuperar comentários.
ID da Pasta
Selecione a pasta que contém o ativo do qual deseja listar comentários.
ID de Ativo
Selecione o ativo para o qual deseja listar comentários.
Limite
Defina o número máximo de comentários que Workfront Fusion retornará durante um ciclo de execução.

Atualizar um comentário

Este módulo de ação edita um comentário existente.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe proprietária do projeto que contém o ativo no qual você deseja atualizar um comentário.
ID de Projeto
Selecione o projeto \ que contém o ativo no qual você deseja atualizar um comentário.
ID da Pasta
Selecione a pasta que contém o ativo sobre o qual deseja atualizar um comentário.
ID de Ativo
Selecione o ativo no qual deseja atualizar um comentário.
ID de Comentário
Selecione o comentário que deseja atualizar.
Texto
Insira o conteúdo do texto do comentário.
Carimbo de Data/Hora
Insira o número do quadro no vídeo ao qual o comentário está vinculado.

Assista ao comentário atualizado

Este módulo de acionamento inicia um cenário quando um comentário é editado.

Nome do Webhook
Insira o nome do webhook, por exemplo, Comment Edited.
Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione a equipe para a qual este webhook foi criado.

Assistir ao Novo Comentário

Este módulo de acionamento inicia um cenário quando um novo comentário ou resposta é criado.

Nome do Webhook
Insira o nome do webhook, por exemplo Novo comentário.
Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione a equipe para a qual este webhook foi criado.

Projetos

Listar Projetos

Este módulo de pesquisa recupera todos os projetos da equipe especificada.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
ID da Equipe
Selecione ou mapeie a equipe para a qual deseja recuperar projetos.
Limite
Defina o número máximo de projetos que Workfront Fusion retornará durante um ciclo de execução.

Outro

Fazer uma chamada de API

Este módulo permite executar uma chamada de API personalizada.

Conexão
Para obter instruções sobre como criar uma conexão com Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion neste artigo.
URL

Insira um caminho relativo para https://api.frame.io. Exemplo: /v2/teams

Observação: para obter a lista de endpoints disponíveis, consulte a Referência de API Frame.io.

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 cabeçalhos de autorização automaticamente.

Cadeia de Consulta
Insira a string de consulta da solicitação. Para cada parâmetro que você deseja incluir na cadeia de caracteres de consulta, clique em Adicionar item e insira o nome do campo e o valor desejado.
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.

Exemplo: a chamada de API a seguir retorna todas as equipes e seus detalhes na sua conta Frame.io:

URL: /v2/teams

Método: GET

O resultado pode ser encontrado na Saída do módulo em Pacote > Corpo.

Em nosso exemplo, os detalhes de 1 equipe foram retornados:

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