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 o Dashboard.
-
Abra a seção Authorization>API Keys.
-
Clique em Create New API key.
-
Insira o nome da chave de API, habilite os escopos que deseja usar e clique em Create.
-
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 Create a connection 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 Continue 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.
Tarefas comuns
Capture a Website
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.
Convert a file
Converte um arquivo em um formato de saída selecionado.
Create an Archive
Permite adicionar um ou vários arquivos ao arquivo ZIP, RAR, 7Z, TAR, TAR.GZ ou TAR.BZ2.
Merge Files
Mescla pelo menos dois arquivos em um PDF. Se os arquivos de entrada não forem PDF, eles serão convertidos automaticamente em PDF.
Optimize a File
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
Create a Job (advanced)
Este módulo cria uma tarefa. Um trabalho pode ser uma ou várias tarefas identificadas no campo Name e vinculadas entre si usando o campo Input.
Delete a Job
Este módulo exclui um trabalho, incluindo todas as tarefas e dados.
Get a Job
Este módulo recupera detalhes do job.
List Jobs
Este módulo recupera todas as tarefas que foram executadas em sua conta.
New Job Event
Acionado quando um trabalho em sua conta ou tarefa é criado, concluído ou falha.
- O trabalho criado pelo módulo Create a Job (advanced) consiste em várias tarefas.
- O gatilho New Job Event 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 I don’t know the input format na caixa de diálogo Add a task. Caso contrário, o erro será retornado.
-
Vincular tarefas no trabalho (nome > entrada, nome > entrada,…):
Tarefas
Cancel a Task
Este módulo cancela uma tarefa que tem um status de espera ou processamento.
Delete a Task
Excluir uma tarefa, incluindo todos os dados.
Download a File
Este módulo recupera o nome do arquivo e os dados do arquivo da tarefa especificada.
Get a Task
Este módulo recupera detalhes da tarefa.
List Tasks
Este módulo recupera todas as tarefas em sua conta com base nas configurações de filtro.
Retry a Task
Este módulo cria uma nova tarefa, baseada nas configurações (carga útil) de outra tarefa.
Outro
Get My Info
Recupera detalhes da conta autenticada sobre o usuário atual.
Make an API Call
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.
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 Bundle > Body > data.
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:
Maximum number of repeats exceeded.
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 > Convert a File 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 Allow storing of Incomplete Executions 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 Download a file no módulo CloudConvert > Convert a file. 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
New Job Event.
Exemplo de fluxo de trabalho para o conector CloudConvert
-
Clique em Select File e escolha seu arquivo MOV de exemplo.
-
Clique na lista suspensa, ao lado de Convert to e escolha MP4.
-
Clique no ícone wrench.
-
Defina as configurações de compactação MP4 conforme desejar.
-
Clique em Convert.
-
Quando a conversão estiver concluída, clique em Download.
-
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.