Frame.io módulos V4

IMPORTANT
Este artigo descreve a nova versão do conector Frame.io. Esse conector é usado para conectar ao Frame.io versão 4.
Para obter instruções sobre a versão herdada do conector Frame.io, consulte Conector herdado Frame.io.

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.

O Workfront oferece dois conectores Frame.io, com base na versão do Frame.io à qual você está se conectando.

Conector
Versão do Frame.io
Frame.io
V4
Frame.io (Herdado)
V3

Para obter instruções sobre a versão herdada do conector Frame.io, consulte Conector herdado Frame.io.

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

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

Informações da API do Frame.io

O conector Frame.io usa o seguinte:

URL básica
https://api.frame.io/v4
Versão da API
v2
Tag da API
v1.0.76

Conectar Frame.io ao Adobe Workfront Fusion

Você pode se conectar automaticamente com credenciais de usuário, criar manualmente uma conexão de credencial de usuário ou criar uma conexão de servidor para servidor.

Conectar-se automaticamente com credenciais de usuário

Este método cria uma conexão automaticamente se você estiver conectado ao Frame.io ou conecta você à página de logon do Frame.io para que você possa fazer logon.

  1. Em qualquer módulo Frame.io do Beta, clique em Adicionar ao lado da caixa Conexão.
  2. Insira um nome para a conexão.
  3. Clique em Continuar.
  4. Se for solicitado que você faça logon em sua conta Frame.io, faça isso.
  5. Se você fizer parte de mais de uma organização Frame.io, selecione a organização que deseja usar para essa conexão.

A conexão é criada.

Criar uma conexão de credenciais do usuário manualmente

Você pode criar uma conexão de credenciais do usuário fazendo logon no Frame.io ou fornecendo uma ID do cliente ou um Segredo do cliente.

Para criar uma conexão servidor a servidor, primeiro você deve configurar um aplicativo no Adobe Developer Console.

Criar credenciais de usuário na Adobe Developer Console

Se você ainda não tiver credenciais de servidor para servidor em um projeto do Adobe Developer Console, poderá criá-las.

  1. Abra o Adobe Developer Console.

  2. Selecione um projeto existente no Adobe Developer Console para usar nesta conexão

    Ou

    Crie um novo projeto na Adobe Developer Console. Para obter instruções, consulte Criar um projeto vazio.

  3. Na página Visão geral do projeto ou na página Introdução ao novo projeto, clique em Adicionar API.

  4. Na página que abre, localize e clique em API Frame.io.

  5. Na página Selecionar tipo de autenticação, selecione Autenticação de Usuário e clique em Avançar.

  6. Na página Adicionar uma credencial de autenticação de usuário, selecione OAuth Web App e clique em Avançar.

  7. Na página Configurar credencial do aplicativo web OAuth, digite o seguinte:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    URI de redirecionamento padrão https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2
    Padrão de URI de redirecionamento https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2
  8. Clique em Avançar.

  9. Clique em Salvar API configurada.

  10. Na página do produto, clique no cartão das credenciais que você acabou de criar.

    Aqui, você pode encontrar sua ID do cliente e o Segredo do cliente.

NOTE
Recomendamos deixar essa janela aberta quando você começar a configurar sua conexão no Adobe Workfront Fusion. Você pode copiar a ID do cliente, recuperar e copiar o Segredo do cliente desta página para colar nos campos de conexão.

Configurar uma conexão de autenticação de usuário

  1. Em qualquer módulo Frame.io do Beta, clique em Adicionar ao lado da caixa Conexão.

  2. Na caixa Criar uma conexão, clique em Mostrar configurações avançadas.

  3. Preencha os seguintes campos:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Tipo de conexão Selecione Autenticação de usuário do IMS.
    Nome da Conexão Insira um nome para esta conexão.
    ID do Cliente

    Insira sua Adobe ID do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    Para obter instruções sobre como criar credenciais, consulte Criar credenciais de usuário no Adobe Developer Console neste artigo.

    Segredo do Cliente

    Insira seu Adobe Segredo do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    Para obter instruções sobre como criar credenciais, consulte Criar credenciais de usuário no Adobe Developer Console neste artigo.

  4. Se for solicitado que você faça logon em sua conta Frame.io, faça isso.

  5. Se você fizer parte de mais de uma organização Frame.io, selecione a organização que deseja usar para essa conexão.

A conexão é criada.

Criar uma conexão de servidor para servidor

Para criar uma conexão servidor a servidor, primeiro você deve configurar um aplicativo no Adobe Developer Console.

Criar credenciais de servidor para servidor no Adobe Developer Console

Se você ainda não tiver credenciais de servidor para servidor em um projeto do Adobe Developer Console, poderá criá-las.

  1. Abra o Adobe Developer Console.

  2. Selecione um projeto existente no Adobe Developer Console para usar nesta conexão

    Ou

    Crie um novo projeto na Adobe Developer Console. Para obter instruções, consulte Criar um projeto vazio.

  3. Na página Visão geral do projeto ou na página Introdução ao novo projeto, clique em Adicionar API.

  4. Na página que abre, localize e clique em API Frame.io.

  5. Na página Selecionar tipo de autenticação, selecione Autenticação de Servidor para Servidor e clique em Avançar.

  6. Insira um nome para as credenciais. Isso permite identificar as credenciais posteriormente na área Credenciais da API do Adobe Admin Console.

  7. Clique em Avançar.

  8. Na página Selecionar perfis de produto, selecione o perfil de produto que inclui a conta Frame.io à qual você deseja se conectar.

  9. Clique em Salvar API configurada.

  10. Na página do produto, clique no cartão das credenciais que você acabou de criar.

    Aqui, você pode encontrar sua ID do cliente e o Segredo do cliente.

NOTE
Recomendamos deixar essa janela aberta quando você começar a configurar sua conexão no Adobe Workfront Fusion. Você pode copiar a ID do cliente, recuperar e copiar o Segredo do cliente desta página para colar nos campos de conexão.

Configurar uma conexão servidor a servidor

  1. Em qualquer módulo Frame.io do Beta, 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 layout-auto html-authored no-header
    Tipo de conexão Selecione Servidor IMS para Servidor.
    Nome da Conexão Insira um nome para esta conexão.
    ID do Cliente

    Insira sua Adobe ID do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    Para obter instruções sobre como criar credenciais, consulte Criar credenciais de servidor para servidor no Adobe Developer Console neste artigo.

    Segredo do Cliente

    Insira seu Adobe Segredo do Cliente. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.

    Para obter instruções sobre como criar credenciais, consulte Criar credenciais de servidor para servidor no Adobe Developer Console neste artigo.

  3. Clique em Continuar para salvar a conexão e retornar ao 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.

Alternância de mapa

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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que contém o projeto para o qual você deseja criar um ativo.
Workspace ID
Selecione o espaço de trabalho ou mapeie a ID do espaço de trabalho que contém o 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.
Caminho
Selecione o caminho onde deseja criar um ativo.
Nome do Arquivo
Insira o nome do arquivo que deseja usar para este ativo.
Tamanho do arquivo
Insira ou mapeie o tamanho do arquivo em bytes.
URL DO Source
Se estiver criando um arquivo, insira o URL do arquivo do qual deseja fazer upload.
Tipo de mídia
Selecione o tipo de mídia para este 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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta 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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que contém o ativo que você deseja recuperar.
ID de Ativo
Selecione ou mapeie o ativo que deseja recuperar.

Listar ativos

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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que contém os ativos que você deseja listar.
Número máximo de ativos retornados
Insira ou mapeie o número máximo de ativos que você deseja que o módulo retorne durante cada ciclo de execução de cenário.

Inspecionar ativo excluído

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

Selecione o webhook que deseja usar para esse módulo ou clique em Adicionar ao lado do campo Webhook e insira as seguintes informações:

Nome do Webhook
Insira um nome para o novo webhook.
Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que deseja observar para ativos excluídos.

Observar novo ativo

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

Selecione o webhook que deseja usar para esse módulo ou clique em Adicionar ao lado do campo Webhook e insira as seguintes informações:

Nome do Webhook
Insira um nome para o novo webhook.
Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que você deseja observar para novos ativos.

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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que contém o ativo ao qual você deseja adicionar um comentário.
Workspace ID
Selecione a conta ou mapeie a ID do espaço de trabalho 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.
Caminho
Selecione o caminho para o ativo ao qual deseja adicionar um comentário.
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.
Página
Se o ativo for uma PDF, insira ou mapeie a página à qual o comentário deve ser anexado.

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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que contém o comentário que você deseja excluir.
ID de Comentário
Insira ou mapeie a ID do 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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que contém o comentário sobre o qual você deseja recuperar detalhes.
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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta que contém o ativo do qual deseja recuperar comentários.
Workspace ID
Selecione ou mapeie o espaço de trabalho que contém o ativo do qual deseja recuperar comentários.
ID de Projeto
Selecione o projeto que contém o ativo do qual deseja recuperar comentários.
Caminho
Selecione o caminho que leva ao ativo do qual deseja listar comentários.
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.

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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta que contém o projeto que contém o ativo no qual você 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.
Página
Se o ativo for uma PDF, insira ou mapeie a página à qual o comentário está anexado.

Assista ao comentário atualizado

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

Selecione o webhook que deseja usar para esse módulo ou clique em Adicionar ao lado do campo Webhook e insira as seguintes informações:

Nome do Webhook
Insira um nome para o novo webhook.
Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que deseja observar para ver comentários atualizados.

Assista ao novo comentário

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

Selecione o webhook que deseja usar para esse módulo ou clique em Adicionar ao lado do campo Webhook e insira as seguintes informações:

Nome do Webhook
Insira um nome para o novo webhook.
Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que deseja observar para novos comentários.

Pastas

Criar uma pasta

Este módulo de ação cria uma nova pasta no Frame.io.

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta na qual deseja criar uma pasta.
Workspace ID
Selecione ou mapeie o espaço de trabalho em que deseja criar uma pasta.
ID de Projeto
Selecione a onde deseja criar uma pasta.
Caminho
Selecione o caminho no qual deseja criar uma pasta.
Nome
Insira ou mapeie um nome para a nova pasta.

Projetos

Criar um projeto

Este módulo de ação cria um novo projeto no Frame.io.

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta na qual deseja criar um projeto.
Workspace ID
Selecione ou mapeie o espaço de trabalho em que deseja criar um projeto.
Nome
Insira ou mapeie um nome para o novo projeto.

Convidar usuários para o projeto Frame.io

Este módulo de ação convida os usuários para o projeto Frame.io especificado.

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta que contém o projeto para o qual você deseja convidar um usuário.
Workspace ID
Selecione ou mapeie o espaço de trabalho que contém o projeto para o qual você deseja convidar um usuário.
ID do projeto
Selecione ou mapeie o projeto para o qual você deseja convidar um usuário.
ID de usuário
Selecione ou mapeie o usuário que deseja convidar para o projeto.

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 o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta que contém o ativo do qual deseja recuperar projetos.
Workspace ID
Selecione ou mapeie o espaço de trabalho que contém o ativo do qual deseja recuperar projetos.
Número máximo de projetos retornados
Inserir ou mapear o número máximo de projetos você deseja que o módulo retorne durante cada ciclo de execução do cenário.

Compartilhamento

Esses módulos de ação adicionam um ativo a um link de compartilhamento no Frame.io.

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta que contém o link de compartilhamento ao qual você deseja adicionar um ativo.
Compartilhar ID de link
Selecione ou mapeie o link de compartilhamento ao qual você deseja adicionar um ativo.
ID de Ativo
Insira ou mapeie a ID do ativo que deseja adicionar ao link de compartilhamento.

Este módulo de ação cria um novo link de compartilhamento no Frame.io.

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta na qual deseja criar um link de compartilhamento.
Workspace ID
Selecione ou mapeie o espaço de trabalho em que deseja criar um link de compartilhamento.
ID de Projeto
Selecione ou mapeie o projeto no qual deseja criar um link de compartilhamento.
Acesso
Selecione se este link tem acesso público ou restrito.
Ativos
Para cada ativo que você deseja adicionar ao link de compartilhamento, clique em Adicionar item e insira a ID do ativo.
Descrição
Insira ou mapeie uma descrição para o link de compartilhamento.
Nome
Insira ou mapeie a data de expiração do link de compartilhamento.
Nome
Insira ou mapeie um nome para o novo link de compartilhamento.
Nome
Insira ou mapeie uma senha para o link de compartilhamento.

Espaços de trabalho

Criar um espaço de trabalho

Este módulo de ação cria um novo espaço de trabalho no Frame.io

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta na qual deseja criar um espaço de trabalho.
Nome
Insira ou mapeie um novo nome para o espaço de trabalho.

Listar espaços de trabalho

Este módulo lista todos os espaços de trabalho em uma conta.

Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione ou mapeie a conta que contém o ativo do qual você deseja recuperar espaços de trabalho.
Número máximo de espaços de trabalho retornados
Insira ou mapeie o número máximo de espaços de trabalho você deseja que o módulo retorne durante cada ciclo de execução do cenário.

Outras

Fazer uma chamada de API personalizada

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

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

Insira um caminho relativo para https://api.frame.io. Exemplo: /v4/me

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

Observação:

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

Observar valor de metadados atualizado

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

Selecione o webhook que deseja usar para esse módulo ou clique em Adicionar ao lado do campo Webhook e insira as seguintes informações:

Nome do Webhook
Insira um nome para o novo webhook.
Conexão
Para obter instruções sobre como criar uma conexão com o Frame.io, consulte Conectar o Frame.io ao Adobe Workfront Fusion neste artigo.
ID de Conta
Selecione a conta ou mapeie a ID da conta que deseja observar para valores de metadados atualizados.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3