Módulos de CloudConvert
En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que utilizan CloudConvert, así como conectarlo a varias aplicaciones y servicios de terceros. Los módulos CloudConvert le permiten supervisar y administrar trabajos, tareas e importar y exportar archivos en su cuenta de CloudConvert.
Información de API de CloudConvert
El conector CloudConvert utiliza lo siguiente:
Conectar CloudConvert a Workfront Fusion connect-cloudconvert-to-workfront-fusion
Para conectar tu cuenta de CloudConvert a Workfront Fusion, debes obtener la clave de API de tu cuenta de CloudConvert.
-
Inicie sesión en su cuenta de CloudConvert y abra su Dashboard.
-
Abra la sección Authorization>API Keys.
-
Haga clic en Create New API key.
-
Escriba el nombre de la clave de API, habilite los ámbitos que desee usar y haga clic en Create.
-
Copie el token proporcionado y guárdelo en un lugar seguro.
-
En Workfront Fusion, empiece a crear un escenario y abra el cuadro de diálogo Create a connection del módulo CloudConvert.
Para obtener instrucciones, vea Crear un escenario en Adobe Workfront Fusion.
-
Escriba el token que guardó en el paso 5 y luego haga clic en Continue para establecer la conexión.
Módulos de CloudConvert y sus campos cloudconvert-modules-and-their-fields
Al configurar módulos de CloudConvert, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse CloudConvert campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.
Tareas comunes
Capture a Website
Este módulo de acción captura un sitio web especificado y lo guarda en formato PDF, JPG de la o PNG.
Usted especifica la dirección URL del sitio web y otra información, como dónde desea almacenar la información.
El módulo devuelve el ID del archivo y cualquier campo asociado, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Convert a file
Convierte un archivo en un formato de salida seleccionado.
Create an Archive
Permite añadir uno o varios archivos al archivo ZIP, RAR, 7Z, TAR, TAR.GZ o TAR.BZ2.
Merge Files
Combina al menos dos archivos en un PDF. Si los archivos de entrada no son PDF, se convierten automáticamente en PDF.
Optimize a File
Este módulo de acción optimiza y comprime un archivo en formato PDF, PNG o formato de JPG.
Especifique el archivo y los parámetros para optimizarlo y almacenarlo.
El módulo devuelve el identificador del archivo y cualquier campo asociado, junto con cualquier otro campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Trabajos
Create a Job (advanced)
Este módulo crea un trabajo. Un trabajo puede ser una o varias tareas identificadas en el campo Name y vinculadas entre sí mediante el campo Input.
Delete a Job
Este módulo elimina un trabajo, incluidas todas las tareas y datos.
Get a Job
Este módulo recupera los detalles del trabajo.
List Jobs
Este módulo recupera todos los trabajos que se han ejecutado en su cuenta.
New Job Event
Déclencheur cuando se crea, finaliza o falla un trabajo en su cuenta o tarea.
- El trabajo creado por el módulo Create a Job (advanced) consta de varias tareas.
- El déclencheur New Job Event también se activa cuando se crea, finaliza o falla una tarea individual.
-
Si trabaja con el agregador de matrices (por ejemplo, tiene muchos archivos en diferentes formatos para convertir), use la opción I don’t know the input format en el cuadro de diálogo Add a task. De lo contrario, se devuelve el error.
-
Vinculando tareas dentro del trabajo (nombre > entrada, nombre > entrada, etc.):
Tareas
Cancel a Task
Este módulo cancela una tarea con un estado de espera o procesamiento.
Delete a Task
Eliminar una tarea, incluidos todos los datos.
Download a File
Este módulo recupera el nombre de archivo y los datos de archivo de la tarea especificada.
Get a Task
Este módulo recupera los detalles de la tarea.
List Tasks
Este módulo recupera todas las tareas de la cuenta en función de la configuración del filtro.
Retry a Task
Este módulo crea una nueva tarea en función de la configuración (carga útil) de otra tarea.
Otro
Get My Info
Recupera detalles de cuenta autenticada acerca del usuario actual.
Make an API Call
Le permite realizar una llamada de API personalizada.
Seleccione el método de petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, vea Métodos de solicitud HTTP.
Escriba una ruta relativa a https://api.cloudconvert.com/. Por ejemplo: /v2/tasks
Para obtener la lista de extremos disponibles, consulte la Documentación de la API CloudConvert v2.
Añada los encabezados de la solicitud en forma de objeto JSON estándar.
Por ejemplo: {"Content-type":"application/json"}
Workfront Fusion 2.0 agrega los encabezados de autorización por usted.
Añada la consulta para la llamada de API en forma de objeto JSON estándar.
Por ejemplo: {"name":"something-urgent"}
if en su JSON, ponga las comillas fuera de la instrucción condicional.
Ejemplo: tareas de lista
La siguiente llamada de API devuelve todas las tareas de su cuenta de CloudFront:
URL: /v2/tasks
Método: GET
Las coincidencias de la búsqueda se pueden encontrar en la salida del módulo en Bundle > Body > data.
En nuestro ejemplo, se devolvieron 6 tareas:
Resolución de problemas troubleshooting
Consulte la siguiente tabla para ver los posibles errores y sus soluciones:
RuntimeError:
Maximum number of repeats exceeded.
Busque el trabajo CloudConvert correspondiente en la lista de trabajos del panel CloudConvert y compruebe la duración del trabajo:
El tiempo de espera del módulo CloudConvert > Convert a File se establece en 3 minutos. Si la duración del trabajo supera los 3 minutos (posiblemente debido a una sobrecarga temporal del servicio CloudConvert), el módulo genera el error mencionado anteriormente.
En este caso, considere una de estas opciones:
- Habilite la opción Allow storing of Incomplete Executions en la configuración de escenario para almacenar las ejecuciones incompletas para una resolución manual posterior. Opcionalmente, puede adjuntar una ruta de control de errores al módulo CloudConvert con la directiva Break para resolver automáticamente las ejecuciones incompletas.
- Deshabilite la opción Download a file en el módulo CloudConvert > Convert a file. En este caso, el módulo no esperará el resultado de la conversión. Para obtener el resultado de la conversión, cree un nuevo escenario y use el déclencheur CloudConvert > New Job Event.
Ejemplo de flujo de trabajo para el conector CloudConvert
-
Haga clic en Select File y seleccione el archivo MOV de muestra.
-
Haga clic en el menú desplegable situado junto a Convert to y elija MP4.
-
Haga clic en el icono wrench.
-
Configure los ajustes de compresión de MP4 como lo crea conveniente.
-
Haga clic en Convert.
-
Una vez completada la conversión, haga clic en Download.
-
Revise el vídeo convertido.
-
Repita los pasos del 1 al 8 hasta que encuentre la configuración de conversión óptima para el paso 5.
-
Visite https://cloudconvert.com/api/v2/convert#convert-tasks
-
Elija mov para el campo input_format.
-
Elija mp4 para el campo output_format.
-
Una lista de todos los parámetros posibles como video_codec, crf, etc. aparecerán.
-
En Workfront Fusion 2.0, inserte el módulo CloudConvert > Convert a File en su escenario.
-
Abra la configuración del módulo.
-
Configure el módulo como se muestra a continuación:
-
Asegúrese de incluir todos los ajustes en el campo Conversión y opciones específicas del motor: para cada ajuste del paso 5, busque el parámetro correspondiente del paso 13 y su valor correspondiente.