Dropbox módulos

Em um cenário do Adobe Workfront Fusion, você pode automatizar fluxos de trabalho que usam o Dropbox ou o Dropbox Business, bem como conectá-lo a vários aplicativos e serviços de terceiros. Isso permite automatizar atividades como monitoramento, pesquisa, recuperação, listagem, criação e edição de arquivos e pastas no Dropbox.

Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: í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 Dropbox, você deve ter uma conta Dropbox.
IMPORTANT
  • Para usar o conector do Dropbox, primeiro crie um aplicativo no Dropbox.
    ​> Para obter mais informações, pesquise por "Criar um aplicativo" no guia do desenvolvedor do Dropbox.
  • Ao criar o aplicativo, use o seguinte URI de redirecionamento: https://app.workfrontfusion.com/oauth/cb/dropbox
  • A Dropbox deve aprovar aplicativos com mais de 50 usuários.
    ​> Para obter mais informações, pesquise por "Aprovação de produção" no guia do desenvolvedor do Dropbox.

Informações da API do Dropbox

O conector do Dropbox usa o seguinte:

URL básica
https://api.dropboxapi.com/2
Versão da API
2
Tag da API
  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Criar uma conexão com Dropbox

Para criar uma conexão para seus módulos do Dropbox:

  1. Em qualquer módulo, 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 6-row-2 layout-auto html-authored no-header
    Nome da Conexão Insira um nome para esta conexão.
    Ambiente Selecione se essa conexão é para um ambiente de produção ou não produção.
    Tipo Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    ID do Cliente Insira sua Dropbox ID do cliente.
    Segredo do Cliente Insira seu Dropbox Segredo do Cliente.
    Tipo de Conta Selecione se você está se conectando a uma conta pessoal da Dropbox ou a uma conta comercial (Dropbox Business).
    Excluir cabeçalho dropbox-api-path-root Habilite essa opção para excluir o cabeçalho dropbox-api-path-root para aplicativos Dropbox com acesso à pasta de aplicativos
  3. Clique em Continuar para salvar a conexão e retornar ao módulo.## Dropbox módulos e seus campos

Dropbox módulos e seus campos

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

Módulos acionadores

Observar arquivos

Este módulo de tipo de Acionador retorna detalhes do arquivo quando ele é modificado em uma pasta especificada.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Pasta
Selecione a pasta que deseja observar alterações.
Observar também subpastas
Habilite esta opção para também monitorar subpastas na pasta selecionada para arquivos modificados.
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.

Módulos para obter Dropbox arquivos e pastas

Baixar um Arquivo

Este módulo de ação baixa um arquivo de uma pasta.

Especifique o arquivo e seu local.

O módulo retorna a ID do arquivo e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

NOTE
Esse módulo é útil para fornecer arquivos aos módulos subsequentes.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Forma de selecionar arquivos
Selecione se deseja mapear o caminho do arquivo ou selecione o arquivo manualmente.
Caminho do arquivo / Arquivo

Caminho do arquivo

Insira ou mapeie o caminho de destino para o arquivo.

Arquivo

Selecione o arquivo no menu.

Obter Metadados de Pasta

Este módulo de ação recupera os detalhes da pasta compartilhada.

Especifique a ID da pasta.

O módulo retorna a ID da pasta e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
ID da Pasta Compartilhada
Insira ou mapeie a ID da pasta da qual deseja recuperar detalhes.

Listar Todos os Arquivos/Subpastas em uma Pasta

Este módulo de ação lista arquivos ou pastas em uma pasta específica.

Especifique a ID da pasta.

O módulo retorna as IDs dos arquivos ou pastas e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Lista
Selecione se deseja recuperar arquivos ou pastas.
Mostrar apenas arquivos baixáveis
Habilite esta opção para retornar somente os arquivos baixáveis. Alguns tipos de arquivos, como o Google Docs, não podem ser baixados.
Pasta
Insira ou mapeie a pasta da qual deseja recuperar arquivos ou pastas.
Limite
Insira ou mapeie o número máximo de registros que deseja que o módulo liste durante cada ciclo de execução de cenário.

Listar revisões de arquivos

Este módulo de ação recupera todas as revisões de arquivo (um histórico de versões) de um arquivo específico.
Especifique a ID do arquivo.

O módulo retorna quaisquer campos padrão associados ao registro, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Forma de selecionar arquivos
Selecione se deseja mapear o caminho do arquivo ou selecione o arquivo manualmente.
Caminho do arquivo / Arquivo

Caminho do arquivo

Insira ou mapeie o caminho de destino para o arquivo.

Arquivo

Selecione o arquivo no menu.

Limite
Insira ou mapeie o número máximo de registros que deseja que o módulo liste durante cada ciclo de execução de cenário.

Pesquisar Arquivos/Pastas

Este módulo de pesquisa procura registros em um objeto em Dropbox que correspondam à consulta de pesquisa especificada.

Você pode mapear essas informações em módulos subsequentes no cenário.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Pesquisar
Insira o termo de pesquisa.
Pasta
Selecione a pasta que deseja pesquisar. Este módulo pesquisa toda a conta Dropbox se você não selecionar uma pasta.
Status do arquivo
Selecione o status do arquivo que deseja incluir na pesquisa.
Categorias de arquivo
Selecione as categorias de arquivo que deseja incluir na pesquisa.
Extensões de arquivo
Para cada extensão de arquivo que você deseja incluir na pesquisa, clique em Adicionar item e insira ou mapeie a extensão de 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.

Módulos para criação e edição de Dropbox arquivos e pastas

Criar uma pasta

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

Especifique o caminho e um nome para a pasta.

O módulo retorna a ID da pasta e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Nome da Pasta
Insira o nome da nova pasta.
Pasta

Insira ou mapeie o caminho onde deseja criar uma nova pasta.

Observação:

Se você estiver usando uma conta do Dropbox Business (com espaços de equipe), remova a barra / ou não clique Clique aqui para escolher a pasta para criar uma pasta de equipe na raiz.

Se a barra não for removida, um erro [409] path/malformed_path/.. será retornado.

Renomear automaticamente
Ative esta opção para renomear a nova pasta, se uma pasta com o mesmo nome já existir no local de destino.

Criar/Substituir um Arquivo de Texto

Esse módulo de ação cria um arquivo DOC ou substitui o conteúdo de um existente.

Especifique o arquivo de origem e a pasta.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Selecionar para

Selecione se deseja criar ou substituir um arquivo DOC.

  • Criar Selecione a pasta na qual deseja criar um arquivo.

  • Substituir

    Selecione como você deseja escolher o arquivo a ser substituído e, em seguida, mapeie o caminho do arquivo ou selecione o arquivo.

Arquivo Source

Selecione um arquivo de origem de um módulo anterior ou mapeie o conteúdo do arquivo de origem.

Se você estiver criando um arquivo, selecione Vazio.

Este módulo de ação cria um link público para um arquivo.

Especifique o arquivo e as informações sobre o link.

O módulo retorna a ID do link e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Maneira de selecionar arquivos
Selecione se deseja mapear ou inserir o caminho do arquivo ou selecione o arquivo manualmente.
Caminho/Arquivo

Caminho do Arquivo

Insira ou mapeie o caminho para o arquivo de destino.

Arquivo

Selecione o arquivo de destino.

Solicitou Visibilidade

Selecione se o link é público, para equipe ou com senha restrita.

Observação:

Equipe somente está disponível somente para contas do Dropbox Business. O Access com senha está disponível somente para contas Dropbox Pro ou Dropbox Business.

Data de expiração do link
Insira a data e a hora em que o link expirará e não estará mais acessível. Se esse campo ficar vazio, o link não expirará. Para obter uma lista de formatos de data e hora com suporte, consulte Coerção de tipo.
Nível de Acesso do Link

Defina a permissão para o recipient do link.

  • Viewer

    Os usuários que usam o link podem exibir e comentar no conteúdo.

  • Editor

    Os usuários que usam o link podem editar, exibir e comentar no conteúdo. Esse nível de acesso está disponível somente para documentos baseados em nuvem.

  • Máx.

    Os usuários que usam o link recebem o nível de acesso máximo para o qual você pode definir o link.

Excluir um Arquivo/Pasta

Este módulo de ação exclui um arquivo ou pasta.

Especifique o arquivo ou pasta.

O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Maneira de selecionar arquivos
Selecione se deseja mapear ou inserir o caminho do arquivo ou selecione o arquivo manualmente.
Caminho do Arquivo ou da Pasta / Arquivo ou Pasta

Caminho de Arquivo/Pasta

Insira ou mapeie o caminho de destino para o arquivo ou pasta.

Arquivo/Pasta

Selecione o arquivo ou pasta no menu.

Mover um Arquivo/Pasta

Este módulo de ação move um arquivo ou pasta para um local diferente.

Especifique o arquivo ou pasta e como e onde deseja movê-lo.

O módulo retorna a ID do arquivo ou pasta e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Maneira de selecionar arquivos/pastas
Selecione se deseja mapear ou inserir o caminho do arquivo ou pasta ou selecione o arquivo ou pasta manualmente.
Arquivo / Caminho da Pasta /

Caminho de Arquivo/Pasta

Insira ou mapeie o caminho de destino para o arquivo ou pasta.

Arquivo/Pasta

Selecione se você está movendo um arquivo ou pasta e, em seguida, o arquivo ou pasta.

Para Pasta
Insira ou mapeie o local de destino do arquivo ou pasta.
Novo Nome
Digite o novo nome do arquivo ou pasta no novo local.
Renomear Automaticamente
Habilite esta opção para garantir que, se existir um arquivo ou pasta com o mesmo nome, o módulo renomeie o novo arquivo ou pasta adicionando (NUMBER) após o nome do arquivo ou pasta. Caso contrário, o arquivo ou pasta no local de destino será substituído.
Permitir transferência de propriedade
Ative essa opção para permitir movimentações por proprietário, mesmo que resulte em uma transferência de propriedade para o conteúdo que está sendo movido.

Renomear um Arquivo/Pasta

Esse módulo de ação renomeia um arquivo ou pasta.

Especifique o arquivo ou pasta e o novo nome.

O módulo retorna a ID do arquivo ou pasta e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Forma de selecionar arquivos
Selecione se deseja mapear ou inserir o caminho do arquivo ou selecione o arquivo manualmente.
Caminho de arquivo/pasta/Arquivo/Pasta

Caminho do arquivo/pasta

Insira ou mapeie o caminho de destino para o arquivo ou pasta.

Arquivo/Pasta

Selecione se você está movendo um arquivo ou pasta e, em seguida, o arquivo ou pasta.

Renomear
Insira o novo nome do arquivo, incluindo a extensão.

Restaurar um Arquivo

Este módulo de ação restaura uma versão anterior de um arquivo.

Especifique o arquivo e o número da revisão desejada.

O módulo retorna a ID da versão e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Maneira de selecionar arquivos
Selecione se deseja mapear ou inserir o caminho do arquivo ou selecione o arquivo manualmente.
Caminho do Arquivo / Arquivo

Caminho do Arquivo

Insira ou mapeie o caminho de destino para o arquivo.

Arquivo

Selecione o arquivo no menu.

Revisão
Informe ou mapeie o número da revisão que deseja restaurar.

Carregar um arquivo

Este módulo de ação faz upload de um arquivo para uma pasta.

Especifique informações como o local do arquivo, o arquivo que deseja fazer upload e um novo nome opcional para o arquivo.

O módulo retorna a ID do arquivo e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
Pasta
Selecione a pasta do Dropbox para a qual você deseja carregar o arquivo.
Arquivo Source

Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.

Observação:

O tamanho máximo do arquivo carregado é de 150 MB.

Substituir um arquivo existente
Habilite esta opção para substituir o arquivo existente pelo novo arquivo. Se essa opção for deixada desativada, o arquivo carregado será renomeado.

Outros módulos

Fazer uma chamada de API

Este módulo de ação permite fazer uma chamada autenticada personalizada para a API Dropbox. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Dropbox.

Ao configurar esse módulo, os campos a seguir são exibidos.

Conexão
Para obter instruções sobre como conectar sua conta do Dropbox ao Workfront Fusion, consulte Criar uma conexão com o Dropbox neste artigo.
URL
Digite um caminho relativo a Digite um caminho relativo a https://api.dropboxapi.com. Por exemplo, /2/files/list_folder
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
Insira os cabeçalhos de solicitação desejados. O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.
Cadeia de Consulta
Insira a string de consulta da solicitação.
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.

recommendation-more-help

Exemplo:

A chamada de API a seguir retorna os primeiros 10 arquivos da pasta /Text files da sua conta Dropbox:

URL: /2/files/list_folder

Corpo:

{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}

Correspondências da pesquisa podem ser encontradas na Saída do módulo em Pacote > Corpo > entradas.

No nosso exemplo, 10 tíquetes foram retornados.

Problemas comuns

Não é possível carregar ou atualizar um arquivo

Os motivos a seguir podem ser uma falha no upload ou na atualização de um arquivo:

  • O arquivo carregado é muito grande e excede o tamanho máximo de arquivo permitido para o plano Dropbox, ou você usou toda a cota de armazenamento da sua conta Dropbox. Você deve excluir arquivos existentes da sua conta Dropbox ou atualizar seu plano.
  • A pasta selecionada anteriormente, para a qual o arquivo está sendo carregado, não existe mais. O cenário é interrompido e você deve selecionar a pasta de destino novamente.

A URL retornada pela Dropbox >Criar um link compartilhado não está vinculada diretamente a uma imagem, mas a uma página Dropbox. Para forçar o download da imagem, substitua o ?dl=0 à direita por ?dl=1. Para forçar a imagem a ser renderizada (por exemplo, em um navegador da Web ou no Facebook Messenger), anexe &raw=1 à URL.

Se você precisar obter o link direto ou bruto da imagem para o seu site ou para outros módulos do Workfront Fusion, modifique o URL compartilhado inicial da seguinte maneira:

URL original:

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

  1. Substituir www por dl.
  2. Remover ?dl=0.

URL final:

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

Para modificar automaticamente a URL, você pode usar a função replace() duas vezes:

  • Substituir www por dl

    Substituir www por dl

  • E para remover ?dl=0

    Remover DL

Para fazer isso em uma etapa, combine estas funções:

Substituir ambos

Também é possível copiá-la e colá-la no campo. Substituir 1.url pela URL.

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3