Configurer des outils et un compte d’extension d’interface utilisateur
Avant de pouvoir créer une extension d’interface utilisateur pour Workfront Fusion, vous devez configurer vos outils et votre compte . Cela ne doit être fait qu’une seule fois.
Conditions préalables
Pour configurer vos outils d’extensibilité de l’interface utilisateur et votre compte , vous avez besoin des éléments suivants :
-
Un Adobe ID ayant accès à une organisation Adobe. Il s’agit du compte que vous utilisez pour vous connecter à Fusion.
-
Accès des développeurs à App Builder. L’administrateur de votre organisation devra peut-être vous accorder le rôle Développeur et vous ajouter à un Profil de produit qui inclut App Builder. Si, par la suite, des commandes échouent avec « vous n’êtes pas un développeur » ou si vous ne pouvez pas voir votre organisation, demandez à votre administrateur d’organisation Adobe de vous ajouter.
-
Administrateur système (éventuellement un autre membre de votre équipe) pour l’étape de publication finale. La création et le déploiement nécessitent uniquement le rôle Développeur, mais l’envoi d’une extension pour approbation/publication nécessite le rôle Administrateur système.
Pour plus d’informations sur les niveaux d’accès Adobe, voir
Accès dans la documentation d’Adobe. -
Ordinateur sur lequel vous pouvez installer un logiciel et exécuter des commandes de terminal (macOS, Windows ou Linux).
Installation de Node.js
L’outil Adobe s’exécute sur Node.js. Vous devez installer la version LTS (18 ou 20).
-
Accédez à https://nodejs.org et téléchargez le programme d’installation de LTS.
-
Exécutez le programme d’installation et acceptez les valeurs par défaut.
-
Confirmez que cela a fonctionné en ouvrant un terminal et en exécutant :
code language-sh node --version npm --versionVous devriez voir les numéros de version (par exemple
v20.17.0et10.x). -
(Conditionnel) Si
noden’est pas trouvé, fermez et rouvrez votre terminal ou redémarrez votre ordinateur. -
Passez à Installation de l’interface de ligne de commande Adobe I/O (
aio).
- Si vous utilisez plusieurs versions de nœud, un gestionnaire de versions tel que
nvmest pratique, mais facultatif. - L’interface de ligne de commande d’Adobe nécessite Node 18 ou une version ultérieure. Les toutes nouvelles versions non-LTS peuvent occasionnellement entraîner des problèmes. Nous vous recommandons donc d’utiliser LTS.
Installation de l’interface de ligne de commande Adobe I/O (aio)
L’outil de ligne de commande que vous utilisez pour créer, créer et publier votre extension est appelé aio.
Pour l’installer globalement :
-
Utilisez la commande
npmsuivante sur votre ligne de commande.code language-sh npm install -g @adobe/aio-cli -
Vérifiez qu’il est installé à l’aide de la commande suivante :
code language-sh aio --versionVous devriez voir quelque chose comme
@adobe/aio-cli/11.x.x. -
Passez à Connexion à Adobe.
sudo. Au lieu de cela, corrigez les autorisations de dossier globales de npm ou utilisez un gestionnaire de versions de nœud qui s’installe dans votre répertoire personnel.Connexion à Adobe
-
Connectez l’interface de ligne de commande à votre compte Adobe avec la commande suivante :
code language-sh aio login -
Dans la fenêtre du navigateur qui s’ouvre, connectez-vous avec votre Adobe ID et approuvez l’accès.
-
Une fois la connexion établie, fermez l’onglet du navigateur et revenez au terminal.
-
(Facultatif) Pour vous déconnecter ultérieurement (par exemple pour changer de compte), utilisez la commande :
aio logout. -
Continuez pour Confirmer votre organisation active.
Confirmer votre organisation active
Vérifiez l’organisation vers laquelle pointe l’interface de ligne de commande :
aio console org list # see organizations you can use
aio console where # see your currently selected org/project/workspace
Si vous appartenez à plusieurs organisations, sélectionnez celle qui convient :
aio console org select
Vous êtes maintenant prêt à créer le projet.