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 basehttps://api.frame.io/v2
Version de l’APIv2
Balise APIv1.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
  9. Cliquez sur Continuer pour établir la connexion et revenir au 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 et revenir au 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.

    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 et revenir au 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 Mappage des informations d’un module à un autre.

Basculement de carte

Ressources

Créer une ressource

Ce module d’action crée une ressource.

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet pour lequel vous souhaitez créer une ressource.
Project IDSélectionnez le projet ou mappez l’ID du projet pour lequel vous souhaitez créer une ressource.
Folder IDSélectionnez le dossier ou mappez l’ID du dossier dans lequel vous souhaitez créer une ressource.
TypeIndiquez si vous souhaitez créer un dossier ou un fichier.
NameSaisissez le nom du nouveau fichier ou dossier.
Source URLSi vous créez un fichier, saisissez l’URL du fichier que vous souhaitez charger.
DescriptionSi vous créez un fichier, saisissez une brève description de la ressource.
LabelSi vous créez un fichier, indiquez si le fichier est en cours, s’il doit être examiné ou s’il est approuvé.

Supprimer une ressource

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

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

Obtenir une ressource

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

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet qui contient la ressource dont vous souhaitez récupérer les détails.
Project IDSélectionnez le projet qui contient la ressource dont vous souhaitez récupérer les détails.
Folder IDSélectionnez le dossier contenant la ressource dont vous souhaitez récupérer les détails.
Asset IDSé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é.

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet contenant le dossier dont vous souhaitez récupérer les ressources.
Project IDSélectionnez le projet contenant le dossier dont vous souhaitez récupérer les ressources.
Folder IDSélectionnez le dossier dont vous souhaitez répertorier les ressources.
LimitSaisissez ou mappez le nombre maximal de ressources que le module doit renvoyer au cours de chaque cycle d’exécution de scénario.

Mettre à jour une ressource

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

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet dont vous souhaitez mettre à jour une ressource.
Project IDSélectionnez le projet ou mappez l’ID du projet pour lequel vous souhaitez mettre à jour une ressource.
Folder IDSélectionnez le dossier ou mappez l’ID du dossier dans lequel vous souhaitez mettre à jour une ressource.
Asset IDSaisissez ou mappez l’identifiant de la ressource à mettre à jour.
NameSaisissez le nom du fichier mis à jour.
DescriptionSaisissez 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 appartenant à l’équipe spécifiée est supprimée.

Comme il s’agit d’un déclencheur instantané, vous devez sélectionner ou créer un webhook à utiliser par le module.

Si vous ajoutez un webhook, saisissez les informations suivantes.

Webhook nameSaisissez un nom pour le webhook, tel que « Ressource supprimée ».
ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez l’équipe pour laquelle ce webhook est créé.

Surveiller un libellé de ressource mis à jour

Ce module de déclenchement lance un scénario lorsqu’un libellé pour une ressource appartenant à l’équipe spécifiée est défini, modifié ou supprimé.

Comme il s’agit d’un déclencheur instantané, vous devez sélectionner ou créer un webhook à utiliser par le module.

Si vous ajoutez un webhook, saisissez les informations suivantes.

Webhook nameSaisissez un nom pour le webhook, tel que « Statut de la ressource mis à jour ».
ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSé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 pour l’équipe spécifiée.

Comme il s’agit d’un déclencheur instantané, vous devez sélectionner ou créer un webhook à utiliser par le module.

Si vous ajoutez un webhook, saisissez les informations suivantes.

Webhook nameSaisissez un nom pour le webhook, tel que « Ressource créée ».
ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSé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.

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, consultez la section Connecter Frame.io à Adobe Workfront Fusion dans cet article.
TypeIndiquez si vous souhaitez créer un commentaire ou répondre à un commentaire.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet contenant la ressource à laquelle vous souhaitez ajouter un commentaire.
Project IDSélectionnez le projet ou mappez l’ID du projet qui contient la ressource à laquelle vous souhaitez ajouter un commentaire.
Folder IDSélectionnez le dossier ou mappez l’ID du dossier contenant la ressource à laquelle vous souhaitez ajouter un commentaire.
Asset IDSélectionnez ou mappez la ressource à laquelle vous souhaitez ajouter un commentaire.
Comment IDSélectionnez ou mappez le commentaire auquel vous souhaitez ajouter une réponse.
TextSaisissez le contenu textuel du commentaire ou de la réponse.
TimestampSaisissez 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.

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

Obtenir un commentaire

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

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet qui contient le dossier dont vous souhaitez récupérer les ressources.
Project IDSélectionnez le projet contenant le dossier dont vous souhaitez récupérer les ressources.
Folder IDSélectionnez le dossier dont vous souhaitez répertorier les ressources.
Asset IDSélectionnez la ressource contenant le commentaire que vous souhaitez récupérer.
Comment IDSé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.

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet qui contient le dossier dont vous souhaitez récupérer les commentaires.
Project IDSélectionnez le projet contenant le dossier dont vous souhaitez récupérer les commentaires.
Folder IDSélectionnez le dossier contenant la ressource dont vous souhaitez répertorier les commentaires.
Asset IDSélectionnez la ressource pour laquelle vous souhaitez répertorier les commentaires.
LimitSaisissez ou mappez le nombre maximum de commentaires que vous souhaitez que le module renvoie lors de chaque cycle d’exécution du scénario.

Mettre à jour un commentaire

Ce module d’action modifie un commentaire existant.

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe propriétaire du projet qui contient la ressource dont vous souhaitez mettre à jour un commentaire.
Project IDSélectionnez le projet contenant la ressource sur laquelle vous souhaitez mettre à jour un commentaire.
Folder IDSélectionnez le dossier contenant la ressource dont vous souhaitez mettre à jour un commentaire.
Asset IDSélectionnez la ressource dont vous souhaitez mettre à jour un commentaire.
Comment IDSélectionnez le commentaire à mettre à jour.
TextSaisissez le contenu textuel du commentaire.
TimestampSaisissez 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é.

Comme il s’agit d’un déclencheur instantané, vous devez sélectionner ou créer un webhook à utiliser par le module.

Si vous ajoutez un webhook, saisissez les informations suivantes.

Webhook nameSaisissez le nom du webhook, par exemple Commentaire modifié.
ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSé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.

Comme il s’agit d’un déclencheur instantané, vous devez sélectionner ou créer un webhook à utiliser par le module.

Si vous ajoutez un webhook, saisissez les informations suivantes.

Webhook nameSaisissez le nom du webhook, par exemple : Nouveau commentaire.
ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSé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.

ConnectionPour obtenir des instructions sur la création d’une connexion à Frame.io, voir Connecter Frame.io à Adobe Workfront Fusion dans cet article.
Team IDSélectionnez ou mappez l’équipe dont vous souhaitez récupérer les projets.
LimitSaisissez ou mappez le nombre maximal de projets que le module doit renvoyer au cours de chaque cycle d'exécution du scénario.