DocumentationWorkfrontGuide Workfront

Modules Frame.io

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Les modules Adobe Workfront Fusion Frame.io vous permettent de surveiller, créer, mettre à jour, récupérer ou supprimer des ressources et des commentaires dans votre compte Frame.io.

Pour obtenir une vidéo d’introduction au connecteur Frame.io, consultez ce qui suit :

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Conditions préalables

Pour utiliser des modules Frame.io, vous devez disposer d’un compte Frame.io.

Informations sur l’API Frame.io

Le connecteur Frame.io utilise les éléments suivants :

URL de base
https://api.frame.io/v2
Version de l’API
v2
Balise API
v1.0.76

Connecter Frame.io à Adobe Workfront Fusion

Vous pouvez vous connecter à Frame.io à l’aide d’un jeton API ou d’OAuth 2.0.

Se connecter à Frame.io à l’aide d’un jeton API

Se connecter à Frame.io à l’aide d’OAuth 2.0 PKCE

Se connecter à Frame.io à l’aide d’un jeton API

Pour connecter votre compte Frame.io à Workfront Fusion à l’aide d’un jeton API, vous devez créer le jeton API dans votre compte Frame.io et l’insérer dans la boîte de dialogue Créer une connexion de Workfront Fusion Frame.io.

  1. Connectez-vous à votre compte Frame.io.
  2. Accédez à la page Jetons dans Développement Frame.io.
  3. Cliquez sur Nouveau.
  4. Saisissez le nom du jeton, sélectionnez les portées à utiliser, puis cliquez sur Créer.
  5. Copiez le jeton fourni.
  6. Accédez à Workfront Fusion et ouvrez la boîte de dialogue Créer une connexion du module Frame.io.
  7. Dans le champ Type de connexion, sélectionnez Frame.io.
  8. Saisissez le jeton que vous avez copié à l’étape 5 dans le champ Votre clé API Frame.io, puis cliquez sur Continuer pour établir la connexion.

La connexion a été établie. Vous pouvez poursuivre la configuration du module.

Se connecter à Frame.io à l’aide d’OAuth 2.0 PKCE

Vous pouvez créer une connexion à Frame.io à l’aide d’OAuth 2.0 PKCE avec un identifiant client facultatif. Si vous souhaitez inclure un identifiant client dans votre connexion, vous devez créer une application OAuth 2.0 dans votre compte Frame.io.

Se connecter à Frame.io à l’aide d’OAuth 2.0 PKCE (sans identifiant client)

  1. Accédez à Workfront Fusion et ouvrez la boîte de dialogue Créer une connexion du module Frame.io.
  2. Dans le champ Type de connexion, sélectionnez Frame.ioOAuth 2.0 PKCE.
  3. Saisissez le nom de la nouvelle connexion dans le champ Nom de la connexion.
  4. Cliquez sur Continuer pour établir la connexion.

La connexion a été établie. Vous pouvez poursuivre la configuration du module.

Se connecter à Frame.io en utilisant OAuth 2.0 PKCE (avec un identifiant client)

  1. Créez une application OAuth 2.0 dans Frame.io. Pour obtenir des instructions, voir la documentation Frame.io sur Flux d’autorisation du code OAuth 2.0.

    note important
    IMPORTANT
    Lorsque vous créez l’application OAuth 2.0 dans Frame.io, procédez comme suit :

    • Saisissez l’URI de redirection suivant :

      Amériques/APAC https://app.workfrontfusion.com/oauth/cb/frame-io5

      EMEA https://app-eu.workfrontfusion.com/oauth/cb/frame-io5

    • Activez l’option PCKE.

  2. Copiez la valeur client_id fournie.

  3. Accédez à Workfront Fusion et ouvrez la boîte de dialogue Créer une connexion du module Frame.io.

  4. Dans le champ Type de connexion, sélectionnez Frame.ioOAuth 2.0 PKCE.

  5. Saisissez le nom de la nouvelle connexion dans le champ Nom de la connexion.

  6. Cliquez sur Afficher les paramètres avancés.

  7. Saisissez la valeur client_id que vous avez copiée à l’étape 2 dans le champ ID client.

  8. Cliquez sur Continuer pour établir la connexion.

La connexion a été établie. Vous pouvez poursuivre la configuration du module.

Modules Frame.io et leurs champs

Lorsque vous configurez les modules Frame.io, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Frame.io supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mapper des informations d’un module à un autre dans Adobe Workfront Fusion.

Ressources

Créer une ressource

Ce module d’action crée une ressource.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet pour lequel vous souhaitez créer une ressource.
Project ID
Sélectionnez le projet ou mappez l’ID du projet pour lequel vous souhaitez créer une ressource.
Folder ID
Sélectionnez le dossier ou mappez l’ID du dossier dans lequel vous souhaitez créer une ressource.
Type
Indiquez si vous souhaitez créer un dossier ou un fichier.
Name
Saisissez le nom du nouveau fichier ou dossier.
Source URL
Saisissez l’URL du fichier à charger.
Description
Saisissez une brève description de la ressource.

Supprimer une ressource

Ce module d’action supprime une ressource spécifiée.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet qui contient la ressource à supprimer.
Project ID
Sélectionnez le projet qui contient la ressource à supprimer.
Folder ID
Sélectionnez le dossier contenant la ressource à supprimer.
Asset ID
Sélectionnez ou mappez la ressource à supprimer.

Obtenir une ressource

Ce module d’action récupère les détails d’une ressource.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet qui contient la ressource dont vous souhaitez récupérer les détails.
Project ID
Sélectionnez le projet qui contient la ressource dont vous souhaitez récupérer les détails.
Folder ID
Sélectionnez le dossier contenant la ressource dont vous souhaitez récupérer les détails.
Asset ID
Sélectionnez la ressource ou mappez l’ID de la ressource dont vous souhaitez récupérer les détails.

Répertorier des ressources

Ce module de recherche récupère toutes les ressources dans le dossier du projet spécifié.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet contenant le dossier dont vous souhaitez récupérer les ressources.
Project ID
Sélectionnez le projet contenant le dossier dont vous souhaitez récupérer les ressources.
Folder ID
Sélectionnez le dossier dont vous souhaitez répertorier les ressources.
Limit
Définissez le nombre maximal de ressources que Workfront Fusion renverra pendant un cycle d’exécution.

Update an Asset

Ce module d’action vous permet de mettre à jour le nom, la description ou les champs personnalisés d’une ressource existante.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet dont vous souhaitez mettre à jour une ressource.
Project ID
Sélectionnez le projet ou mappez l’ID du projet pour lequel vous souhaitez mettre à jour une ressource.
Folder ID
Sélectionnez le dossier ou mappez l’ID du dossier dans lequel vous souhaitez mettre à jour une ressource.
Name
Saisissez le nom du fichier mis à jour.
Description
Saisissez une brève description de la ressource mise à jour.

Surveiller une ressource supprimée

Ce module de déclenchement démarre un scénario lorsqu’une ressource est supprimée.

Webhook name
Saisissez le nom du webhook, par exemple Ressource supprimée.
Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez l’équipe pour laquelle ce webhook est créé.

Surveiller un libellé de ressource mis à jour

Ce module de déclenchement démarre un scénario lorsque le statut d’une ressource est défini, modifié ou supprimé.

Webhook name
Saisissez le nom du webhook, par exemple Statut de la ressource mis à jour.
Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez l’équipe pour laquelle ce webhook est créé.

Surveiller une nouvelle ressource

Ce module de déclenchement démarre un scénario lorsqu’une nouvelle ressource est créée.

Webhook name
Saisissez le nom du webhook, par exemple Ressource créée.
Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez l’équipe pour laquelle ce webhook est créé.

Commentaires

Créer un commentaire

Ce module d’action ajoute un nouveau commentaire ou une nouvelle réponse à la ressource.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, consultez la section Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Type
Indiquez si vous souhaitez créer un commentaire ou répondre à un commentaire.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet contenant la ressource à laquelle vous souhaitez ajouter un commentaire.
Project ID
Sélectionnez le projet ou mappez l’ID du projet qui contient la ressource à laquelle vous souhaitez ajouter un commentaire.
Folder ID
Sélectionnez le dossier ou mappez l’ID du dossier contenant la ressource à laquelle vous souhaitez ajouter un commentaire.
Asset ID
Sélectionnez ou mappez la ressource à laquelle vous souhaitez ajouter un commentaire.
Comment ID
Sélectionnez ou mappez le commentaire auquel vous souhaitez ajouter une réponse.
Text
Saisissez le contenu textuel du commentaire ou de la réponse.
Timestamp
Saisissez le numéro de l’image dans la vidéo à laquelle le commentaire doit être lié.

Supprimer un commentaire

Ce module d’action supprime un commentaire existant.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet qui contient la ressource dont vous souhaitez supprimer un commentaire.
Project ID
Sélectionnez le projet ou mappez l’ID du projet qui contient la ressource dont vous souhaitez supprimer un commentaire.
Folder ID
Sélectionnez le dossier contenant la ressource dont vous souhaitez supprimer un commentaire.
Asset ID
Sélectionnez la ressource contenant le commentaire à supprimer.
Comment ID
Sélectionnez le commentaire à supprimer.

Obtenir un commentaire

Ce module d’action récupère les détails du commentaire spécifié.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet qui contient le dossier dont vous souhaitez récupérer les ressources.
Project ID
Sélectionnez le projet contenant le dossier dont vous souhaitez récupérer les ressources.
Folder ID
Sélectionnez le dossier dont vous souhaitez répertorier les ressources.
Asset ID
Sélectionnez la ressource contenant le commentaire que vous souhaitez récupérer.
Comment ID
Sélectionnez le commentaire dont vous souhaitez récupérer les détails.

Répertorier des commentaires

Ce module de recherche récupère tous les commentaires de la ressource spécifiée.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet qui contient le dossier dont vous souhaitez récupérer les commentaires.
Project ID
Sélectionnez le projet contenant le dossier dont vous souhaitez récupérer les commentaires.
Folder ID
Sélectionnez le dossier contenant la ressource dont vous souhaitez répertorier les commentaires.
Asset ID
Sélectionnez la ressource pour laquelle vous souhaitez répertorier les commentaires.
Limit
Définissez le nombre maximal de commentaires que Workfront Fusion renverra pendant un cycle d’exécution.

Mettre à jour un commentaire

Ce module d’action modifie un commentaire existant.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe propriétaire du projet qui contient la ressource dont vous souhaitez mettre à jour un commentaire.
Project ID
Sélectionnez le projet qui contient la ressource dont vous souhaitez mettre à jour un commentaire.
Folder ID
Sélectionnez le dossier contenant la ressource dont vous souhaitez mettre à jour un commentaire.
Asset ID
Sélectionnez la ressource dont vous souhaitez mettre à jour un commentaire.
Comment ID
Sélectionnez le commentaire à mettre à jour.
Text
Saisissez le contenu textuel du commentaire.
Timestamp
Saisissez le numéro de l’image dans la vidéo à laquelle le commentaire est lié.

Surveiller les commentaires mis à jour

Ce module déclencheur lance un scénario lorsqu’un commentaire est modifié.

Webhook name
Saisissez le nom du webhook, par exemple Commentaire modifié.
Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez l’équipe pour laquelle ce webhook est créé.

Surveiller le nouveau commentaire

Ce module déclencheur lance un scénario lors de la création d’un commentaire ou d’une réponse.

Webhook name
Saisissez le nom du webhook, par exemple : Nouveau commentaire.
Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez l’équipe pour laquelle ce webhook est créé.

Projets

Répertorier des projets

Ce module de recherche récupère tous les projets pour l’équipe spécifiée.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team ID
Sélectionnez ou mappez l’équipe dont vous souhaitez récupérer les projets.
Limit
Définissez le nombre maximal de projets que Workfront Fusion renverra pendant un cycle d’exécution.

Autre

Réaliser un appel API

Ce module vous permet d’effectuer un appel API personnalisé.

Connection
Pour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
URL

Saisissez un chemin relatif à https://api.frame.io. Exemple : /v2/teams

Note : pour obtenir la liste des points d’entrée disponibles, voir la référence de l’API Frame.io.

Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.
Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.

Par exemple, {"Content-type":"application/json"}

Workfront Fusion Ajoute automatiquement des en-têtes d’autorisation.

Query String
Saisissez la chaîne de requête. Pour chaque paramètre à inclure dans la chaîne de requête, cliquez sur Add item et saisissez le nom du champ et la valeur souhaitée.
Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lors de l’utilisation d’instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.

Exemple : l’appel API suivant renvoie toutes les équipes et les détails de cet appel dans votre compte Frame.io :

URL : /v2/teams

Méthode : GET

Le résultat se trouve dans la sortie du module sous Lot > Corps.

Dans notre exemple, les détails d’une équipe ont été renvoyés :

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43