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.

NOTE
Cet article suppose que vous connaissez un peu les outils de développement logiciel.

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).

  1. Accédez à https://nodejs.org et téléchargez le programme d’installation de LTS.

  2. Exécutez le programme d’installation et acceptez les valeurs par défaut.

  3. Confirmez que cela a fonctionné en ouvrant un terminal et en exécutant :

    code language-sh
    node --version
    npm --version
    

    Vous devriez voir les numéros de version (par exemple v20.17.0 et 10.x).

  4. (Conditionnel) Si node n’est pas trouvé, fermez et rouvrez votre terminal ou redémarrez votre ordinateur.

  5. Passez à Installation de l’interface de ligne de commande Adobe I/O (aio).

TIP
  • Si vous utilisez plusieurs versions de nœud, un gestionnaire de versions tel que nvm est 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 :

  1. Utilisez la commande npm suivante sur votre ligne de commande.

    code language-sh
    npm install -g @adobe/aio-cli
    
  2. Vérifiez qu’il est installé à l’aide de la commande suivante :

    code language-sh
    aio --version
    

    Vous devriez voir quelque chose comme @adobe/aio-cli/11.x.x.

  3. Passez à Connexion à Adobe.

NOTE
Si une erreur d’autorisations s’affiche sur macOS/Linux, n’utilisez 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

  1. Connectez l’interface de ligne de commande à votre compte Adobe avec la commande suivante :

    code language-sh
    aio login
    
  2. Dans la fenêtre du navigateur qui s’ouvre, connectez-vous avec votre Adobe ID et approuvez l’accès.

  3. Une fois la connexion établie, fermez l’onglet du navigateur et revenez au terminal.

  4. (Facultatif) Pour vous déconnecter ultérieurement (par exemple pour changer de compte), utilisez la commande : aio logout.

  5. 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.

recommendation-more-help
workfront-fusion-help-workfront-fusion