Modules Frame.io V4
Les modules Frame.io d’Adobe Workfront Fusion vous permettent de surveiller, de créer, de mettre à jour, de récupérer ou de supprimer des ressources et des commentaires dans votre compte Frame.io.
Workfront propose deux connecteurs Frame.io, en fonction de la version de Frame.io à laquelle vous vous connectez.
Pour obtenir des instructions sur la version héritée du connecteur Frame.io, consultez Connecteur hérité Frame.io.
Pour obtenir une vidéo d’introduction au connecteur Frame.io, consultez ce qui suit :
Conditions d’accès
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront |
Tout package de workflow Adobe Workfront et tout package d’automatisation et d’intégration Adobe Workfront Workfront Ultimate Packages Workfront Prime et Select, avec l’achat supplémentaire de Workfront Fusion. |
| Licences Adobe Workfront |
Standard Travail ou supérieur |
| Licence Adobe Workfront Fusion |
Basé sur les opérations : aucune exigence de licence Workfront Fusion Basé sur un connecteur (hérité) : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit | Si votre organisation dispose d’un package Workfront Select ou Prime qui n’inclut pas l’automatisation et l’intégration de Workfront, elle doit acquérir Adobe Workfront Fusion. |
Pour plus d’informations sur le contenu de ce tableau, consultez Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez 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 :
Connecter Frame.io à Adobe Workfront Fusion
Vous pouvez vous connecter automatiquement à l’aide des informations d’identification d’utilisateur ou d’utilisatrice, créer manuellement une connexion d’informations d’identification d’utilisateur ou d’utilisatrice ou créer une connexion de serveur à serveur.
Se connecter automatiquement avec les informations d’identification d’utilisateur ou d’utilisatrice
Cette méthode crée automatiquement une connexion si vous êtes connecté à Frame.io, ou vous dirige vers la page de connexion Frame.io afin que vous puissiez vous connecter.
- Dans un module Frame.io, cliquez sur Ajouter en regard de la zone Connexion.
- Saisissez un nom pour la connexion.
- Cliquez sur Continuer.
- Si un message vous invite à vous connecter à votre compte Frame.io, faites-le.
- Si vous faites partie de plusieurs organisations Frame.io, sélectionnez celle que vous souhaitez utiliser pour cette connexion.
La connexion est établie.
Créer manuellement une connexion aux informations d’identification d’un utilisateur ou d’une utilisatrice
Vous pouvez créer une connexion d’informations d’identification d’utilisateur ou d’utilisatrice en vous connectant à Frame.io ou en fournissant un ID client ou un secret client.
Pour créer une connexion serveur à serveur, vous devez d’abord configurer une application dans l’Adobe Developer Console.
Créer des informations d’identification d’utilisateur ou d’utilisatrice dans l’Adobe Developer Console
Si vous ne disposez pas déjà d’informations d’identification de serveur à serveur sur un projet Adobe Developer Console, vous pouvez les créer.
-
Ouvrez l’Adobe Developer Console.
-
Sélectionnez un projet existant dans l’Adobe Developer Console à utiliser pour cette connexion
Ou
Créez un projet dans l’Adobe Developer Console. Pour obtenir des instructions, consultez Créer un projet vide.
-
Sur la page de vue d’ensemble du projet ou sur la page Commencer de votre nouveau projet, cliquez sur Ajouter une API.
-
Sur la page qui s’ouvre, recherchez l’API Frame.io et cliquez dessus.
-
Sur la page Sélectionner le type d’authentification, choisissez Authentification de l’utilisateur ou de l’utilisatrice et cliquez sur Suivant.
-
Sur la page Ajouter des informations d’identification d’authentification d’utilisateur ou d’utilisatrice, sélectionnez Application web OAuth et cliquez sur Suivant.
-
Sur la page Configurer les informations d’identification de l’application web OAuth, saisissez ce qui suit :
table 0-row-2 1-row-2 layout-auto html-authored no-header Default redirect URI https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2Redirect URI pattern https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2 -
Cliquez sur Suivant.
-
Cliquez sur Enregistrer l’API configurée.
-
Sur la page produit, cliquez sur la carte correspondant aux informations d’identification que vous venez de créer.
Vous trouverez ici votre ID client et votre secret client.
Configuration d’une connexion d’authentification utilisateur
-
Dans un module Frame.io, cliquez sur Ajouter en regard de la zone Connexion.
-
Dans la zone Créer une connexion, cliquez sur Afficher les paramètres avancés.
-
Remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Connection type Sélectionnez Authentification de l’utilisateur ou de l’utilisatrice IMS. Connection name Saisissez un nom pour cette connexion. Client ID Saisissez votre Client ID Adobe. Vous pouvez le trouver dans la section Credentials details d’Adobe Developer Console.
Pour obtenir des instructions sur la création d’informations d’identification, consultez Créer des informations d’identification d’utilisateur ou d’utilisatrice dans l’Adobe Developer Console dans cet article.
Client Secret Saisissez votre Client Secret Adobe. Vous pouvez le trouver dans la section Credentials details d’Adobe Developer Console.
Pour obtenir des instructions sur la création d’informations d’identification, consultez Créer des informations d’identification d’utilisateur ou d’utilisatrice dans l’Adobe Developer Console dans cet article.
-
Si un message vous invite à vous connecter à votre compte Frame.io, faites-le.
-
Si vous faites partie de plusieurs organisations Frame.io, sélectionnez celle que vous souhaitez utiliser pour cette connexion.
La connexion est établie.
Créer une connexion de serveur à serveur
Pour créer une connexion serveur à serveur, vous devez d’abord configurer une application dans l’Adobe Developer Console.
Créer des informations d’identification serveur à serveur dans l’Adobe Developer Console
Si vous ne disposez pas déjà d’informations d’identification de serveur à serveur sur un projet Adobe Developer Console, vous pouvez les créer.
-
Ouvrez l’Adobe Developer Console.
-
Sélectionnez un projet existant dans l’Adobe Developer Console à utiliser pour cette connexion
Ou
Créez un projet dans l’Adobe Developer Console. Pour obtenir des instructions, consultez Créer un projet vide.
-
Sur la page de vue d’ensemble du projet ou sur la page Commencer de votre nouveau projet, cliquez sur Ajouter une API.
-
Sur la page qui s’ouvre, recherchez l’API Frame.io et cliquez dessus.
-
Sur la page Sélectionner le type d’authentification, sélectionnez Authentification de serveur à serveur et cliquez sur Suivant.
-
Saisissez un nom pour les informations d’identification. Vous pouvez ainsi identifier les informations d’identification ultérieurement dans la zone Informations d’identification de l’API de l’Adobe Admin Console.
-
Cliquez sur Suivant.
-
Sur la page Sélectionner les profils de produit, sélectionnez le profil de produit qui inclut le compte Frame.io auquel vous souhaitez vous connecter.
-
Cliquez sur Enregistrer l’API configurée.
-
Sur la page produit, cliquez sur la carte correspondant aux informations d’identification que vous venez de créer.
Vous trouverez ici votre ID client et votre secret client.
Configuration d’une connexion de serveur à serveur
-
Dans un module Frame.io, cliquez sur Ajouter en regard de la zone Connexion.
-
Remplissez les champs suivants :
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Connection type Sélectionnez IMS de serveur à serveur. Connection name Saisissez un nom pour cette connexion. Client ID Saisissez votre Client ID Adobe. Vous pouvez le trouver dans la section Credentials details d’Adobe Developer Console.
Pour obtenir des instructions sur la création d’informations d’identification, consultez Créer des informations d’identification de serveur à serveur dans l’Adobe Developer Console dans cet article.
Client Secret Saisissez votre Client Secret Adobe. Vous pouvez le trouver dans la section Credentials details d’Adobe Developer Console.
Pour obtenir des instructions sur la création d’informations d’identification, consultez Créer des informations d’identification de serveur à serveur dans l’Adobe Developer Console dans cet article.
-
Cliquez sur Continuer pour enregistrer 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, consultez Mappage d’informations d’un module à l’autre.
Ressources
Créer une ressource
Ce module d’action crée une ressource. Vous pouvez charger un fichier local ou fournir l’URL d’un fichier distant à partir duquel créer la ressource.
Création d’une ressource (héritée)
Ce module d’action crée une ressource.
Supprimer une ressource
Ce module d’action supprime une ressource spécifiée.
Obtenir une ressource
Ce module d’action récupère les détails d’une ressource.
Répertorier des ressources
Ce module de recherche récupère toutes les ressources dans le dossier du projet spécifié.
Surveiller une ressource supprimée
Ce module de déclenchement démarre un scénario lorsqu’une ressource est supprimée.
Sélectionnez le webhook à utiliser pour ce module ou cliquez sur Ajouter en regard du champ Webhook et saisissez les informations suivantes :
Surveiller une nouvelle ressource
Ce module de déclenchement démarre un scénario lorsqu’une nouvelle ressource est créée.
Sélectionnez le webhook à utiliser pour ce module ou cliquez sur Ajouter en regard du champ Webhook et saisissez les informations suivantes :
Commentaires
Créer un commentaire
Ce module d’action ajoute un nouveau commentaire ou une nouvelle réponse à la ressource.
Supprimer un commentaire
Ce module d’action supprime un commentaire existant.
Obtenir un commentaire
Ce module d’action récupère les détails du commentaire spécifié.
Répertorier des commentaires
Ce module de recherche récupère tous les commentaires de la ressource spécifiée.
Mettre à jour un commentaire
Ce module d’action modifie un commentaire existant.
Surveiller le commentaire mis à jour
Ce module déclencheur lance un scénario lorsqu’un commentaire est mis à jour.
Sélectionnez le webhook à utiliser pour ce module ou cliquez sur Ajouter en regard du champ Webhook et saisissez les informations suivantes :
Surveiller le nouveau commentaire
Ce module déclencheur lance un scénario lorsqu’un commentaire est créé.
Sélectionnez le webhook à utiliser pour ce module ou cliquez sur Ajouter en regard du champ Webhook et saisissez les informations suivantes :
Dossiers
Créer un dossier
Ce module d’action crée un dossier dans Frame.io.
Projets
Créer un projet
Ce module d’action crée un projet dans Frame.io.
Inviter des utilisateurs et utilisatrices à rejoindre le projet Frame.io
Ce module d’action invite les utilisateurs et utilisatrices à rejoindre le projet Frame.io spécifié.
Répertorier des projets
Ce module de recherche récupère tous les projets pour l’équipe spécifiée.
Partages
Ajouter une ressource à un lien de partage
Ce module d’action ajoute une ressource à un lien de partage dans Frame.io.
Créer un lien de partage
Ce module d’action crée un lien de partage dans Frame.io.
Espaces de travail
Créer un espace de travail
Ce module d’action crée un nouvel espace de travail dans Frame.io.
Répertorier les espaces de travail
Ce module répertorie tous les espaces de travail d’un compte.
Métadonnées
Création d’un champ de niveau compte
Ce module d’action crée et configure un champ de métadonnées au niveau du compte.
Suppression d’un champ de niveau compte
Ce module d’action supprime un seul champ de métadonnées au niveau du compte.
Obtenir les métadonnées
Ce module d'action récupère les métadonnées d'un fichier dans Frame.io.
Répertorier les champs au niveau du compte
Ce module récupère une liste des champs de métadonnées de niveau compte pour le compte spécifié.
Mise à jour d’une définition de champ au niveau du compte
Ce module met à jour la définition d’un champ de métadonnées existant unique.
Mise à jour des métadonnées sur plusieurs fichiers
Ce module met à jour les champs de métadonnées d’un ou de plusieurs fichiers avec les valeurs que vous spécifiez.
Autre
Effectuer un appel API personnalisé
Ce module vous permet d’effectuer un appel API personnalisé.
Surveiller les événements
Ce module de déclenchement instantané démarre un scénario lorsque l’événement sélectionné se produit dans Frame.io.
Vous pouvez utiliser un webhook existant ou en créer un nouveau.
Pour créer un webhook :
-
Cliquez sur Ajouter à côté du champ Webhook.
-
Renseignez les informations suivantes :
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Nom du Webhook Saisissez un nom pour le nouveau webhook. 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. Account ID Sélectionnez ou mappez le compte contenant l’espace de travail dans lequel vous souhaitez regarder les événements. Workspace ID Saisissez l’identifiant de l’espace de travail dans lequel vous souhaitez regarder les événements. Events Sélectionnez les événements qui doivent déclencher ce module -
Cliquez sur Enregistrer pour enregistrer le webhook et revenir au module .
-
Cliquez sur OK dans le module Événements Espion pour enregistrer la configuration.
Surveiller la mise à jour de la valeur des métadonnées
Ce module déclencheur lance un scénario lorsqu’un commentaire est mis à jour.
Sélectionnez le webhook à utiliser pour ce module ou cliquez sur Ajouter en regard du champ Webhook et saisissez les informations suivantes :