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.

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plan, Work
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o Plano Select ou Prime Adobe Workfront, sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Ultimate Workfront.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Informações da API CloudConvert

O conector CloudConvert usa o seguinte:

URL base
https://api.cloudconvert.com/v2/
Versão da API
v2
Tag da API
v2.14.22

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.

  1. Faça logon em sua conta do CloudConvert e abra o Dashboard.

  2. Abra a seção Authorization>API Keys.

  3. Clique em Create New API key.

  4. Insira o nome da chave de API, habilite os escopos que deseja usar e clique em Create.

  5. Copie o token fornecido e armazene-o em um local seguro.

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

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

Alternância de mapa

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.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
URL
Insira o URL do site que você deseja capturar.
Output Format
Selecione se deseja salvar o site capturado no formato PNG, JPG ou PDF.
File Name
Insira um nome de arquivo (incluindo a extensão) para o arquivo de saída de destino.
Headers

(Opcional) Defina os cabeçalhos de solicitação.

Isso é útil, por exemplo, quando o URL especificado requer autorização.

Conversion and engine specific options
Especifique opções específicas de conversão e mecanismo. Para exibir as opções disponíveis, consulte a documentação da API CloudConvertpara input_format e output_format.
Download a file
Ative esta opção se você também quiser incluir dados de arquivo na saída do módulo.

Convert a file

Converte um arquivo em um formato de saída selecionado.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Input file
Selecione se deseja carregar um arquivo usando Workfront Fusion ou forneça a URL da qual o arquivo será carregado.
Upload a file
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Import a File from URL
  • URL

    Insira o URL do arquivo que você deseja converter.

  • Headers

    Definir cabeçalhos de solicitação (opcional). Isso é útil, por exemplo, quando o URL especificado requer a autorização.

Format
Selecione se deseja especificar o formato de entrada do arquivo que deseja converter. Se não especificado, a extensão do arquivo de entrada é usada como o formato de entrada.
Input Format
Selecione o formato atual do arquivo.
Output Format
Selecione o formato de arquivo de destino para o qual deseja converter o arquivo.
File Name
Escolha um nome de arquivo (incluindo a extensão) para o arquivo de saída de destino.
Conversion and engine specific options
Especifique opções específicas de conversão e mecanismo. Para exibir as opções disponíveis, consulte a documentação da API CloudConvertpara input_format e output_format.
Download a file
Ative esta opção se você também quiser incluir dados de arquivo na saída do módulo.

Create an Archive

Permite adicionar um ou vários arquivos ao arquivo ZIP, RAR, 7Z, TAR, TAR.GZ ou TAR.BZ2.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Input Files
Especifique os arquivos que deseja adicionar ao arquivo morto.
Upload a File
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Import a file from URL

URL

Insira o URL do arquivo que deseja arquivar.

Headers

Definir cabeçalhos de solicitação (opcional). Isso é útil, por exemplo, quando o URL especificado requer a autorização.

Output Format
Selecione o formato de destino do arquivo arquivado.
File name
Insira o nome do arquivo (incluindo a extensão) para o arquivo de saída de destino.
Conversion and engine specific options
Especifique opções específicas de conversão e mecanismo. Para exibir as opções disponíveis, consulte a documentação da API CloudConvertpara input_format e output_format.
Download a File
Ative esta opção se você também quiser incluir dados de arquivo na saída do módulo.

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.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Input Files
Especifique os arquivos que deseja mesclar.
Upload a File
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Import a file from URL

URL

Insira o URL do arquivo que deseja arquivar.

Headers

Definir cabeçalhos de solicitação (opcional). Isso é útil, por exemplo, quando o URL especificado requer a autorização.

Output Format
Selecione o formato de destino do arquivo mesclado.
File name
Insira o nome do arquivo (incluindo a extensão) para o arquivo de saída de destino.
Conversion and engine specific options
Especifique opções específicas de conversão e mecanismo. Para exibir as opções disponíveis, consulte a documentação da API CloudConvertpara input_format e output_format.
Download a File
Ative esta opção se você também quiser incluir dados de arquivo na saída do módulo.

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.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Input File
Selecione se deseja fazer upload de um arquivo usando o Workfront Fusion ou forneça o URL do qual o arquivo será carregado.
Upload a File
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Import a file from URL
  • URL: digite o URL do arquivo que deseja converter.
  • Headers: (Opcional) Defina os cabeçalhos de solicitação. Isso é útil, por exemplo, quando o URL especificado requer autorização.
Optimization for

Selecione o perfil de otimização para as necessidades do público-alvo específicas.

  • Web: Otimização para a Web (padrão)

    • Remover dados redundantes e desnecessários para a Web
    • Diminua a resolução, corte e compacte imagens de forma inteligente
    • Mesclar e subdefinir fontes
    • Converter cores em RGB
  • Print: otimização para impressão

    • Remova dados redundantes e desnecessários para impressão

    • Diminua a resolução, corte e compacte imagens de forma inteligente

    • Mesclar e subdefinir fontes

    • Converter cores em CMYK

  • Archive: otimização para fins de arquivamento

    • Remova dados redundantes e desnecessários para arquivamento

    • Compactar imagens de forma inteligente

    • Mesclar e subdefinir fontes

  • Scanned images: otimização para imagens digitalizadas

    • Perfil otimizado para PDF que consistem principalmente em imagens rasterizadas

    • Compactar as imagens sem reduzir significativamente a qualidade visual

  • maximal size reduction: otimização para redução máxima do tamanho

    • Usar a compactação máxima possível

    • Pode reduzir a qualidade visual

Input format
Selecione o formato do arquivo de entrada que deseja otimizar.
File name
Insira um nome de arquivo (incluindo a extensão) para o arquivo de saída de destino.
Conversion and engine specific options
Especifique opções específicas de conversão e mecanismo. Para exibir as opções disponíveis, consulte a documentação da API CloudConvertpara input_format e output_format.
Download a file
Ative esta opção se você também quiser incluir dados de arquivo na saída do módulo.

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.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Input Files
Selecione se deseja carregar um arquivo usando Workfront Fusion ou forneça a URL da qual o arquivo será carregado.
Upload a File
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Import a File from URL
  • URL: digite o URL do arquivo que deseja processar.
  • Headers: (Opcional) Defina os cabeçalhos de solicitação. Isso é útil, por exemplo, quando o URL especificado requer autorização.
Tasks

Adicione tarefas que serão executadas dentro do trabalho.

Encontre as descrições dos campos de operações na seção correspondente.

  • Execute a Command

    Para obter mais informações sobre como executar um comando, consulte a CloudConvert documentação da API.

  • Export a File to Temporary URL

    Especifique o nome da tarefa e o nome da tarefa de entrada (por exemplo, Conversão).

Tag
Insira uma tag. Tags são strings arbitrárias para identificar o trabalho. Elas não têm efeito e podem ser usadas para associar o trabalho a uma ID.

Delete a Job

Este módulo exclui um trabalho, incluindo todas as tarefas e dados.

NOTE
As tarefas são excluídas automaticamente 24 horas após terem terminado.
Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Job ID
Informe ou mapeie a ID do job que deseja deletar.

Get a Job

Este módulo recupera detalhes do job.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Job ID
Informe ou mapeie a ID do job sobre o qual deseja recuperar detalhes.

List Jobs

Este módulo recupera todas as tarefas que foram executadas em sua conta.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Status
Selecione o status do trabalho pelo qual filtrar os trabalhos retornados.
Limit
Defina o número de trabalhos que o Workfront Fusion 2.0 retornará durante um ciclo de execução.

New Job Event

Acionado quando um trabalho em sua conta ou tarefa é criado, concluído ou falha.

NOTE
  • 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.
Webhhook name
Insira o nome do webhook.
Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Output Format
Selecione se deseja salvar o site capturado no formato PNG, JPG ou PDF.
Event
Selecione se o módulo será acionado quando a tarefa ou o trabalho for criado, concluído ou falhar.
NOTE
  • 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,…):

    Vinculando nome entre trabalhos >

Tarefas

Cancel a Task

Este módulo cancela uma tarefa que tem um status de espera ou processamento.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Task ID
Insira ou mapeie a ID da tarefa que deseja cancelar.

Delete a Task

Excluir uma tarefa, incluindo todos os dados.

NOTE
As tarefas são excluídas automaticamente 24 horas após terem terminado.
Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Task ID
Insira (mapeie) a ID da tarefa que deseja excluir.

Download a File

Este módulo recupera o nome do arquivo e os dados do arquivo da tarefa especificada.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Task ID
Insira ou mapeie a ID da tarefa da qual deseja baixar o arquivo.

Get a Task

Este módulo recupera detalhes da tarefa.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Task ID
Insira ou mapeie a ID da tarefa sobre a qual deseja recuperar detalhes.

List Tasks

Este módulo recupera todas as tarefas em sua conta com base nas configurações de filtro.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Status
Selecione o status da tarefa pelo qual filtrar as tarefas retornadas.
Job ID
Insira ou mapeie a ID do trabalho para retornar somente tarefas dentro do trabalho especificado.
Operation

Informe o tipo de operação para retornar somente tarefas com a operação especificada.

Observação: use o módulo List Possible Operations para recuperar operações.

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

Retry a Task

Este módulo cria uma nova tarefa, baseada nas configurações (carga útil) de outra tarefa.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.
Task ID
Digite ou mapeie a ID da tarefa da qual deseja criar uma nova tarefa.

Outro

Get My Info

Recupera detalhes da conta autenticada sobre o usuário atual.

Connection
Para obter instruções sobre como conectar sua conta do CloudConvert ao Workfront Fusion, consulte Conectar CloudConvert ao Workfront Fusion neste artigo.

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.

Connection
Para obter instruções sobre como conectar sua conta do [Fusion App] ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas
URL

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.

Method
Headers

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

Query String

Adicione a consulta da chamada à API na forma de um objeto JSON padrão.

Por exemplo: {"name":"something-urgent"}

Body
Adicione o conteúdo do corpo para a chamada de API na forma de um objeto JSON padrão. Ao usar instruções condicionais como 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

Exemplo de entrada da API

Correspondências da pesquisa podem ser encontradas na Saída do módulo em Bundle > Body > data.

No nosso exemplo, 6 tarefas foram retornadas:

Saída de exemplo de API

Solução de problemas troubleshooting

Consulte a tabela a seguir para ver possíveis erros e suas soluções:

Erro
Próximas etapas
The output file size exceeds the limit allowed for your scenario.
Consulte os limites de tamanho de arquivo.
You have exceeded the maximum conversion time.
O plano CloudConvert gratuito oferece 25 minutos de conversão diariamente. Se o seu uso exceder o limite do plano gratuito, você poderá alternar para um pacote (pré-pago) ou assinatura.
Failed to read frame size: Could not seek to 1508. �/output/JLIADSA00137P0.mp3: Invalid argument.
Esse erro é lançado, por exemplo, ao converter arquivos de MP3 para WAV. Verifique se você selecionou a região correta porque ela encontrará referências a arquivos, mas não apenas ao arquivo correto.

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

INFO
Exemplo: Conversão de um vídeo do formato MOV para MP4
  1. Visitar https://cloudconvert.com/video-converter

  2. Clique em Select File e escolha seu arquivo MOV de exemplo.

  3. Clique na lista suspensa, ao lado de Convert to e escolha MP4.

  4. Clique no ícone wrench.

  5. Defina as configurações de compactação MP4 conforme desejar.

  6. Clique em Convert.

  7. Quando a conversão estiver concluída, clique em Download.

  8. Revise o vídeo convertido.

  9. Repita as etapas de 1 a 8 até encontrar as configurações ideais de conversão para a etapa 5.

  10. Visitar https://cloudconvert.com/api/v2/convert#convert-tasks

  11. Escolha mov para o campo input_format.

  12. Escolha mp4 para o campo output_format.

  13. Uma lista de todos os parâmetros possíveis como video_codec, crf, etc. será exibida.

  14. No Workfront Fusion 2.0, insira o módulo CloudConvert > Convert a File no seu cenário.

  15. Abra as configurações do módulo.

  16. Configure o módulo conforme mostrado abaixo:

    Exemplo de CloudConvert

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3