Dropbox módulos
Em um cenário Adobe Workfront Fusion, você pode automatizar fluxos de trabalho que usam Dropbox ou Dropbox Business, bem como conectá-los 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 em seu Dropbox.
Se você precisar de instruções sobre como criar um cenário, consulte Criar um cenário Adobe Workfront Fusion.
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:
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 Dropbox, você deve ter uma conta Dropbox.
Informações da API do Dropbox
O conector Dropbox usa o seguinte:
Criar uma conexão com Dropbox
Para criar uma conexão para seus módulos do Dropbox:
-
Clique em Adicionar ao lado da caixa Conexão.
-
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 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 Dropbox pessoal ou conta comercial (Dropbox Business). -
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 em Adobe Workfront Fusion.
Módulos acionadores
Observar arquivos
Este módulo de tipo de Acionador retorna detalhes do arquivo quando ele é modificado em uma pasta especificada.
Módulos para obter Dropbox arquivos e pastas
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.
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.
Ao configurar esse módulo, os campos a seguir são exibidos.
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.
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.
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.
Módulos para criação e edição de Dropbox arquivos e pastas
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.
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.
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.
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.
Criar/atualizar um link de compartilhamento
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.
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.
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.
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.
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.
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.
Digite um caminho relativo a Digite um caminho relativo a https://api.dropboxapi.com. Por exemplo, /2/files/list_folder
Observação: para obter a lista de pontos de extremidade disponíveis, consulte a Documentação da API v2 do Dropbox.
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.
/2/files/list_folder{"path": "/Text files","limit": 10,"recursive": false,"include_deleted": false}Problemas comuns
Não é possível carregar ou atualizar um arquivo
Há várias situações em que ocorre 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 imagem referenciada por um link compartilhado não é renderizada
A URL retornada por Dropbox >Criar um link compartilhado não se vincula 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 a URL compartilhada 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
- Substituir
wwwpordl. - 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
-
E para remover ?dl=0
Para fazer isso em uma etapa, combine estas funções:
Também é possível copiá-la e colá-la no campo. Substituir 1.url pela URL.
{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}