Frame.io módulos V4

IMPORTANT
Este artículo describe la nueva versión del conector Frame.io. Este conector se utiliza para conectarse a Frame.io versión 4.
Para obtener instrucciones sobre la versión heredada del conector Frame.io, consulte Conector heredado Frame.io.

Los módulos de Adobe Workfront Fusion Frame.io le permiten supervisar, crear, actualizar, recuperar o eliminar recursos y comentarios en su cuenta de Frame.io.

Workfront ofrece dos conectores Frame.io, basados en la versión de Frame.io a la que se está conectando.

Conector
Versión de Frame.io
Frame.io
V4
Frame.io (heredado)
V3

Para obtener instrucciones sobre la versión heredada del conector Frame.io, consulte Conector heredado Frame.io.

Para ver un vídeo introductorio del conector Frame.io, consulte:

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
paquete de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: Trabajo o superior

Licencia de Adobe Workfront Fusion**

Actual: No se requiere licencia de Workfront Fusion

O

Heredado: Workfront Fusion para la automatización e integración del trabajo

Producto

Nuevo:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

O

Actual: Su organización debe comprar Adobe Workfront Fusion.

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.

Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.

Requisitos previos

Para usar módulos Frame.io, debe tener una cuenta de Frame.io

Información de la API Frame.io

El conector Frame.io utiliza lo siguiente:

Dirección URL base
https://api.frame.io/v4
Versión de API
Versión 2
Etiqueta de API
Versión 1.0.76

Conectar Frame.io a Adobe Workfront Fusion

Puede conectarse automáticamente con credenciales de usuario, crear manualmente una conexión de credenciales de usuario o crear una conexión servidor a servidor.

Conectar automáticamente con credenciales de usuario

Este método crea una conexión automáticamente si ha iniciado sesión en Frame.io o le conecta a la página de inicio de sesión de Frame.io para que pueda iniciar sesión.

  1. En cualquier módulo Frame.io de Beta, haga clic en Agregar junto al cuadro Conexión.
  2. Introduzca un nombre para la conexión.
  3. Haga clic en Continuar.
  4. Si se le pide que inicie sesión en su cuenta de Frame.io, hágalo.
  5. Si forma parte de más de una organización Frame.io, seleccione la organización que desee utilizar para esta conexión.

Se crea la conexión.

Crear manualmente una conexión de credenciales de usuario

Puede crear una conexión de credenciales de usuario iniciando sesión en Frame.io o proporcionando un ID de cliente o un Secreto de cliente.

Para crear una conexión servidor a servidor, primero debe configurar una aplicación en Adobe Developer Console.

Crear credenciales de usuario en Adobe Developer Console

Si todavía no tiene credenciales de servidor a servidor en un proyecto de Adobe Developer Console, puede crearlas.

  1. Abra Adobe Developer Console.

  2. Seleccione un proyecto existente en Adobe Developer Console para utilizarlo para esta conexión

    O

    Cree un nuevo proyecto en Adobe Developer Console. Para obtener instrucciones, vea Crear un proyecto vacío.

  3. En la página Información general del proyecto o en la página Introducción a tu nuevo proyecto, haz clic en Agregar API.

  4. En la página que se abre, busque y haga clic en Frame.io API.

  5. En la página Seleccionar tipo de autenticación, seleccione Autenticación de usuario y haga clic en Siguiente.

  6. En la página Agregar una credencial de autenticación de usuario, seleccione Aplicación web de OAuth y haga clic en Siguiente.

  7. En la página Configurar credenciales de aplicación web de OAuth, introduzca lo siguiente:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    URI de redirección predeterminado https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2
    Patrón URI de redireccionamiento https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2
  8. Haga clic en Siguiente.

  9. Haga clic en Guardar API configurada.

  10. En la página del producto, haga clic en la tarjeta de las credenciales que acaba de crear.

    Aquí puede encontrar su ID de cliente y su Secreto de cliente.

NOTE
Se recomienda dejar esta ventana abierta a medida que comience a configurar la conexión en Adobe Workfront Fusion. Puede copiar el ID de cliente y recuperar y copiar el Secreto del cliente de esta página para pegarlo en los campos de conexión.

Configurar una conexión de autenticación de usuario

  1. En cualquier módulo Frame.io de Beta, haga clic en Agregar junto al cuadro Conexión.

  2. En el cuadro Crear una conexión, haga clic en Mostrar configuración avanzada.

  3. Rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection type Seleccione Autenticación de usuario de IMS.
    Connection name Introduzca un nombre para esta conexión.
    Client ID

    Introduzca su Client ID Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.

    Para obtener instrucciones sobre cómo crear credenciales, consulte Crear credenciales de usuario en Adobe Developer Console en este artículo.

    Client Secret

    Introduzca su Adobe Client Secret.  Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.

    Para obtener instrucciones sobre cómo crear credenciales, consulte Crear credenciales de usuario en Adobe Developer Console en este artículo.

  4. Si se le pide que inicie sesión en su cuenta de Frame.io, hágalo.

  5. Si forma parte de más de una organización Frame.io, seleccione la organización que desee utilizar para esta conexión.

Se crea la conexión.

Creación de una conexión servidor a servidor

Para crear una conexión servidor a servidor, primero debe configurar una aplicación en Adobe Developer Console.

Creación de credenciales de servidor a servidor en Adobe Developer Console

Si todavía no tiene credenciales de servidor a servidor en un proyecto de Adobe Developer Console, puede crearlas.

  1. Abra Adobe Developer Console.

  2. Seleccione un proyecto existente en Adobe Developer Console para utilizarlo para esta conexión

    O

    Cree un nuevo proyecto en Adobe Developer Console. Para obtener instrucciones, vea Crear un proyecto vacío.

  3. En la página Información general del proyecto o en la página Introducción a tu nuevo proyecto, haz clic en Agregar API.

  4. En la página que se abre, busque y haga clic en Frame.io API.

  5. En la página Seleccionar tipo de autenticación, seleccione Autenticación de servidor a servidor y haga clic en Siguiente.

  6. Introduzca un nombre para las credenciales. Esto le permite identificar las credenciales más adelante en el área Credenciales de API de Adobe Admin Console.

  7. Haga clic en Siguiente.

  8. En la página Seleccionar perfiles de producto, seleccione el perfil de producto que incluye la cuenta de Frame.io a la que desea conectarse.

  9. Haga clic en Guardar API configurada.

  10. En la página del producto, haga clic en la tarjeta de las credenciales que acaba de crear.

    Aquí puede encontrar su ID de cliente y su Secreto de cliente.

NOTE
Se recomienda dejar esta ventana abierta a medida que comience a configurar la conexión en Adobe Workfront Fusion. Puede copiar el ID de cliente y recuperar y copiar el Secreto del cliente de esta página para pegarlo en los campos de conexión.

Configuración de una conexión servidor a servidor

  1. En cualquier módulo Frame.io de Beta, haga clic en Agregar junto al cuadro Conexión.

  2. Rellene los campos siguientes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection type Seleccionar servidor IMS para servidor.
    Connection name Introduzca un nombre para esta conexión.
    Client ID

    Introduzca su Client ID Adobe. Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.

    Para obtener instrucciones sobre cómo crear credenciales, consulte Crear credenciales de servidor a servidor en Adobe Developer Console en este artículo.

    Client Secret

    Introduzca su Adobe Client Secret.  Esto se puede encontrar en la sección Credentials details de Adobe Developer Console.

    Para obtener instrucciones sobre cómo crear credenciales, consulte Crear credenciales de servidor a servidor en Adobe Developer Console en este artículo.

  3. Haga clic en Continuar para guardar la conexión y volver al módulo.

Módulos de Frame.io y sus campos

Al configurar módulos de Frame.io, Workfront Fusion muestra los campos que se indican a continuación. Junto a estos, pueden aparecer campos de Frame.io adicionales, en función de factores como el nivel de acceso del que disponga 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.

Conmutador Asignar

Recursos

Crear un recurso

Este módulo de acción crea un nuevo recurso.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene el proyecto para el que desea crear un recurso.
Workspace ID
Seleccione el espacio de trabajo o asigne el ID del espacio de trabajo que contiene el proyecto para el que desea crear un recurso.
Project ID
Seleccione el proyecto o asigne el ID del proyecto para el que desea crear un recurso.
Path
Seleccione la ruta en la que desea crear un recurso.
Nombre de archivo
Introduzca el nombre del archivo que desea utilizar para este recurso.
Tamaño del archivo
Introduzca o asigne el tamaño del archivo en bytes.
Source URL
Si crea un archivo, introduzca la dirección URL del archivo que desea cargar.
Tipo de medio
Seleccione el tipo de medio para este recurso.

Eliminar un recurso

Este módulo de acción elimina un recurso especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene el recurso que desea eliminar.
Asset ID
Seleccione o asigne el recurso que desea eliminar.

Obtener un recurso

Este módulo de acción recupera los detalles de un recurso.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene el recurso que desea recuperar.
Asset ID
Seleccione o asigne el recurso que desea recuperar.

Enumerar recursos

Este módulo de búsqueda recupera todos los recursos de la carpeta en el proyecto especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene los recursos que desea enumerar.
Número máximo de recursos devueltos
Introduzca o asigne el número máximo de recursos que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

Ver recurso eliminado

Este módulo de activador inicia un escenario cuando se elimina un recurso.

Seleccione el webhook que desee utilizar para este módulo o haga clic en Agregar junto al campo Webhook e introduzca la siguiente información:

Webhook name
Escriba un nombre para el nuevo webhook.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que desea inspeccionar en busca de recursos eliminados.

Ver nuevo recurso

Este módulo de activador inicia un escenario cuando se crea un nuevo recurso.

Seleccione el webhook que desee utilizar para este módulo o haga clic en Agregar junto al campo Webhook e introduzca la siguiente información:

Webhook name
Escriba un nombre para el nuevo webhook.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que desea ver para ver si hay nuevos recursos.

Comentarios

Crear un comentario

Este módulo de acción añade un nuevo comentario o respuesta al recurso.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene el recurso al que desea agregar un comentario.
Workspace ID
Seleccione la cuenta o asigne el ID del espacio de trabajo que contiene el recurso al que desea agregar un comentario.
Project ID
Seleccione el proyecto o asigne el ID del proyecto que contiene el recurso al que desea añadir un comentario.
Path
Seleccione la ruta al recurso al que desee agregar un comentario.
Text
Introduzca el contenido de texto del comentario o la respuesta.
Timestamp
Introduzca el número de fotograma en el vídeo al que debe vincularse el comentario.
Página
Si el recurso es un PDF, introduzca o asigne la página a la que debe adjuntarse el comentario.

Eliminar un comentario

Este módulo de acción elimina un comentario existente.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene el comentario que desea eliminar.
Comment ID
Introduzca o asigne el ID del comentario que desea eliminar.

Obtener un comentario

Este módulo de acción recupera los detalles del comentario especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que contiene el comentario cuyos detalles desea recuperar.
Comment ID
Seleccione el comentario cuyos detalles desea recuperar.

Enumerar comentarios

Este módulo de búsqueda recupera todos los comentarios del recurso especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta que contiene el recurso del que desea recuperar comentarios.
Workspace ID
Seleccione o asigne el espacio de trabajo que contiene el recurso del que desea recuperar comentarios.
Project ID
Seleccione el proyecto que contiene el recurso del que desea recuperar comentarios.
Path
Seleccione la ruta que lleva al recurso desde el que desea enumerar los comentarios.
Maximum number of returned comments
Introduzca o asigne el número máximo de comentarios que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

Actualizar un comentario

Este módulo de acción edita un comentario existente.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta que contiene el proyecto que contiene el recurso en el que desea actualizar un comentario.
Comment ID
Seleccione el comentario que desea actualizar.
Text
Introduzca el contenido de texto del comentario.
Timestamp
Introduzca el número de fotograma en el vídeo al que está vinculado el comentario.
Página
Si el recurso es un PDF, introduzca o asigne la página a la que está adjunto el comentario.

Ver comentario actualizado

Este módulo de déclencheur inicia un escenario cuando se actualiza un comentario.

Seleccione el webhook que desee utilizar para este módulo o haga clic en Agregar junto al campo Webhook e introduzca la siguiente información:

Webhook name
Escriba un nombre para el nuevo webhook.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que desea ver para ver los comentarios actualizados.

Ver nuevo comentario

Este módulo de déclencheur inicia un escenario cuando se crea un comentario.

Seleccione el webhook que desee utilizar para este módulo o haga clic en Agregar junto al campo Webhook e introduzca la siguiente información:

Webhook name
Escriba un nombre para el nuevo webhook.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que desea ver para ver nuevos comentarios.

Carpetas

Crear una carpeta

Este módulo de acción crea una nueva carpeta en Frame.io.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta donde desea crear una carpeta.
Workspace ID
Seleccione o asigne el espacio de trabajo en el que desea crear una carpeta.
Project ID
Seleccione el donde desea crear una carpeta.
Path
Seleccione la ruta donde desea crear una carpeta.
Nombre
Introduzca o asigne un nombre para la nueva carpeta.

Proyectos

Crear un proyecto

Este módulo de acción crea un nuevo proyecto en Frame.io.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta donde desea crear un proyecto.
Workspace ID
Seleccione o asigne el espacio de trabajo donde desea crear un proyecto.
Nombre
Escriba o asigne un nombre para el nuevo proyecto.

Invitar a usuarios al proyecto Frame.io

Este módulo de acción invita a los usuarios al proyecto Frame.io especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta que contiene el proyecto al que desea invitar a un usuario.
Workspace ID
Seleccione o asigne el espacio de trabajo que contiene el proyecto al que desea invitar a un usuario.
Identificador de proyecto
Seleccione o asigne el proyecto al que desea invitar a un usuario.
Identificador del usuario
Seleccione o asigne al usuario que desea invitar al proyecto.

Enumerar proyectos

Este módulo de búsqueda recupera todos los proyectos del equipo especificado.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta que contiene el recurso del que desea recuperar proyectos.
Workspace ID
Seleccione o asigne el espacio de trabajo que contiene el recurso del que desea recuperar proyectos.
Número máximo de proyectos devueltos
Introduzca o asigne el número máximo de proyectos desea que el módulo se devuelva durante cada ciclo de ejecución de escenario.

Recursos compartidos

Añadir un recurso a un vínculo compartido

Estos módulos de acción añaden un recurso a un vínculo compartido en Frame.io.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta que contiene el vínculo compartido al que desea agregar un recurso.
Compartir vínculo ID
Seleccione o asigne el vínculo compartido al que desee agregar un recurso.
Asset ID
Introduzca o asigne el ID del recurso que desea agregar al vínculo compartido.

Crear un vínculo compartido

Este módulo de acción crea un nuevo vínculo compartido en Frame.io.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta en la que desea crear un vínculo compartido.
Workspace ID
Seleccione o asigne el espacio de trabajo donde desea crear un vínculo compartido.
Project ID
Seleccione o asigne el proyecto donde desea crear un vínculo compartido.
Acceso
Seleccione si este vínculo tiene acceso público o restringido.
Recursos
Para cada recurso que desee agregar al vínculo compartido, haga clic en Agregar elemento e introduzca el ID del recurso.
Descripción
Introduzca o asigne una descripción para el vínculo compartido.
Nombre
Introduzca o asigne la fecha de caducidad del vínculo compartido.
Nombre
Introduzca o asigne un nombre para el nuevo vínculo compartido.
Nombre
Introduzca o asigne una frase de contraseña para el vínculo compartido.

Espacios de trabajo

Crear un espacio de trabajo

Este módulo de acción crea un nuevo espacio de trabajo en Frame.io

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta donde desea crear un espacio de trabajo.
Name
Introduzca o asigne un nombre nuevo para el espacio de trabajo.

Enumerar espacios de trabajo

Este módulo enumera todos los espacios de trabajo de una cuenta.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione o asigne la cuenta que contiene el recurso del que desea recuperar espacios de trabajo.
Número máximo de espacios de trabajo devueltos
Introduzca o asigne el número máximo de espacios de trabajo desea que el módulo se devuelva durante cada ciclo de ejecución de escenario.

Otro

Realizar una llamada de API personalizada

Este módulo le permite realizar una llamada de API personalizada.

Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
URL

Introduzca una ruta relativa a https://api.frame.io. Ejemplo: /v4/me

Nota: Para obtener la lista de los puntos finales disponibles, consulte la Referencia de la API de Frame.io.

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

Añada los encabezados de la solicitud en forma de objeto JSON estándar.

Por ejemplo: {"Content-type":"application/json"}

Workfront Fusion añade encabezados de autorización automáticamente.

Cadena de consulta
Introduzca la cadena de consulta de la solicitud. Para cada parámetro que desee incluir en la cadena de consulta, haga clic en Add item e introduzca el nombre del campo y el valor deseado.
Body

Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.

Nota:

Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.

Ver el valor de metadatos actualizado

Este módulo de déclencheur inicia un escenario cuando se actualiza un comentario.

Seleccione el webhook que desee utilizar para este módulo o haga clic en Agregar junto al campo Webhook e introduzca la siguiente información:

Webhook name
Escriba un nombre para el nuevo webhook.
Connection
Para obtener instrucciones sobre cómo crear una conexión con Frame.io, consulte Conectar Frame.io a Adobe Workfront Fusion en este artículo.
ID de cuenta
Seleccione la cuenta o asigne el ID de la cuenta que desea ver para obtener valores de metadatos actualizados.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3