CloudConvert módulos
Em um cenário do Adobe Workfront Fusion, é possível automatizar workflows que usam o CloudConvert, bem como conectá-lo a vários aplicativos e serviços de terceiros. Os módulos do CloudConvert permitem monitorar e gerenciar trabalhos, tarefas e importar e exportar arquivos na sua conta do CloudConvert.
Informações da API CloudConvert
O conector CloudConvert usa o seguinte:
Conectar CloudConvert a Workfront Fusion connect-cloudconvert-to-workfront-fusion
Para conectar sua conta do CloudConvert ao Workfront Fusion, você precisa obter a Chave de API da sua conta do CloudConvert.
-
Faça logon em sua conta do CloudConvert e abra seu Painel.
-
Abra a seção Autorização > Chaves de API.
-
Clique em Criar nova chave de API.
-
Insira o nome da chave de API, habilite os escopos que deseja usar e clique em Criar.
-
Copie o token fornecido e armazene-o em um local seguro.
-
Em Workfront Fusion, comece a criar um cenário e abra a caixa de diálogo Criar uma conexão do módulo CloudConvert.
Para obter instruções, consulte Criar um cenário Adobe Workfront Fusion.
-
Insira o token salvo na etapa 5 e clique em Continuar para estabelecer a conexão.
CloudConvert módulos e seus campos cloudconvert-modules-and-their-fields
Ao configurar módulos do CloudConvert, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos CloudConvert 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.
Tarefas comuns
Capturar um site
Este módulo de ação captura um site especificado e o salva no formato PDF, JPG ou PNG.
Especifique o URL do site e outras informações, como onde deseja armazenar as informações.
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.
Converter um arquivo
Converte um arquivo em um formato de saída selecionado.
Criar um Arquivo Morto
Permite adicionar um ou vários arquivos ao arquivo ZIP, RAR, 7Z, TAR, TAR.GZ ou TAR.BZ2.
Mesclar arquivos
Mescla pelo menos dois arquivos em um PDF. Se os arquivos de entrada não forem PDF, eles serão convertidos automaticamente em PDF.
Otimizar um Arquivo
Esse módulo de ação otimiza e compacta um arquivo no formato PDF, PNG ou JPG.
Especifique o arquivo e os parâmetros para otimizá-lo e armazená-lo.
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.
Trabalhos
Criar um Trabalho (avançado)
Este módulo cria uma tarefa. Um trabalho pode ser uma ou várias tarefas identificadas no campo Nome e vinculadas entre si usando o campo Entrada.
Excluir um Trabalho
Este módulo exclui um trabalho, incluindo todas as tarefas e dados.
Obter um Trabalho
Este módulo recupera detalhes do job.
Listar Trabalhos
Este módulo recupera todas as tarefas que foram executadas em sua conta.
Novo Evento de Trabalho
Acionado quando um trabalho em sua conta ou tarefa é criado, concluído ou falha.
- O trabalho criado pelo módulo Criar um Trabalho (avançado) consiste em várias tarefas.
- O gatilho Novo Evento de Trabalho também é acionado quando uma tarefa individual é criada, é concluída ou falha.
-
Se estiver trabalhando com o Agregador de Matrizes (por exemplo, você tem muitos arquivos em diferentes formatos para converter), use a opção Desconheço o formato de entrada na caixa de diálogo Adicionar uma tarefa. Caso contrário, o erro será retornado.
-
Vincular tarefas no trabalho (nome > entrada, nome > entrada,…):
Tarefas
Cancelar uma tarefa
Este módulo cancela uma tarefa que tem um status de espera ou processamento.
Excluir uma tarefa
Excluir uma tarefa, incluindo todos os dados.
Baixar um Arquivo
Este módulo recupera o nome do arquivo e os dados do arquivo da tarefa especificada.
Obter uma tarefa
Este módulo recupera detalhes da tarefa.
Listar Tarefas
Este módulo recupera todas as tarefas em sua conta com base nas configurações de filtro.
Repetir uma tarefa
Este módulo cria uma nova tarefa, baseada nas configurações (carga útil) de outra tarefa.
Outro
Obter Minhas Informações
Recupera detalhes da conta autenticada sobre o usuário atual.
Fazer uma chamada de API
Permite executar uma chamada de API personalizada.
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.
Insira um caminho relativo para https://api.cloudconvert.com/. Por exemplo: /v2/tasks
Para obter a lista de pontos de extremidade disponíveis, consulte a CloudConvert Documentação da API v2.
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 2.0 adiciona os cabeçalhos de autorização para você.
Adicione a consulta da chamada à API na forma de um objeto JSON padrão.
Por exemplo: {"name":"something-urgent"}
if em seu JSON, coloque as aspas fora da instrução condicional.
Exemplo: Tarefas de Lista
A chamada de API a seguir retorna todas as tarefas da conta do CloudFront:
URL: /v2/tasks
Método: GET
Correspondências da pesquisa podem ser encontradas na Saída do módulo em Pacote > Corpo > dados.
No nosso exemplo, 6 tarefas foram retornadas:
Solução de problemas troubleshooting
Consulte a tabela a seguir para ver possíveis erros e suas soluções:
RuntimeError:
Número máximo de repetições excedido.
Localize o trabalho CloudConvert correspondente na lista de trabalhos do painel CloudConvert e verifique a duração do trabalho:
O tempo limite do módulo CloudConvert > Converter um Arquivo está definido como 3 minutos. Se a duração do trabalho exceder 3 minutos (possivelmente devido a uma sobrecarga temporária do serviço CloudConvert), o módulo acionará o erro mencionado acima.
Nesse caso, considere uma destas opções:
- Habilite a opção Permitir armazenamento de Execuções Incompletas nas configurações do cenário para armazenar as execuções incompletas para resolução manual posterior. Opcionalmente, você pode anexar uma rota de tratamento de erros ao módulo CloudConvert com a diretiva Break para resolver as execuções incompletas automaticamente.
- Desabilite a opção Baixar um arquivo no módulo CloudConvert > Converter um arquivo. Nesse caso, o módulo não aguardará o resultado da conversão. Para obter o resultado da conversão, crie um novo cenário e use o gatilho CloudConvert > Novo Evento de Trabalho.
Exemplo de fluxo de trabalho para o conector CloudConvert
-
Clique em Selecionar arquivo e escolha seu arquivo MOV de exemplo.
-
Clique na lista suspensa, ao lado de Converter em e escolha MP4.
-
Clique na chave inglesa.
-
Defina as configurações de compactação MP4 conforme desejar.
-
Clique em Converter.
-
Quando a conversão estiver concluída, clique em Baixar.
-
Revise o vídeo convertido.
-
Repita as etapas de 1 a 8 até encontrar as configurações ideais de conversão para a etapa 5.
-
Visitar https://cloudconvert.com/api/v2/convert#convert-tasks
-
Escolha mov para o campo input_format.
-
Escolha mp4 para o campo output_format.
-
Uma lista de todos os parâmetros possíveis como video_codec, crf, etc. será exibida.
-
No Workfront Fusion 2.0, insira o módulo CloudConvert > Convert a File no seu cenário.
-
Abra as configurações do módulo.
-
Configure o módulo conforme mostrado abaixo:
-
Certifique-se de incluir todas as configurações no campo Opções específicas de conversão e mecanismo: para cada configuração da etapa 5, localize o parâmetro correspondente da etapa 13 e seu valor correspondente.