DocumentationAdobe Workfront Fusion

Présentation de l’extensibilité de l’interface utilisateur

Dernière mise à jour : 19 août 2026

L’extensibilité de l’interface utilisateur vous permet d’importer votre logique et votre interface utilisateur personnalisées dans Adobe Workfront Fusion. En utilisant Adobe App Builder, vous pouvez modifier l’expérience Workfront Fusion de votre entreprise afin de mieux répondre aux besoins de l’entreprise, tout en vous appuyant sur les fonctionnalités de base de Fusion.

Cet article donne une vue d’ensemble de l’extensibilité de l’interface utilisateur et de la manière dont votre extension personnalisée communique avec Workfront Fusion.

Structure de l’extension

Hôtes et invités

Fusion peut afficher l’interface utilisateur qui n’a pas été créée par l’équipe de Workfront Fusion. Pour s’assurer que ces modifications de l’interface utilisateur n’affectent pas les fonctionnalités de base de Fusion, l’interface utilisateur s’exécute dans son propre cadre de navigateur isolé (un <iframe>), complètement distinct du code de Fusion.

  • Hôte : application qui contient l’extension. Ici, c’est Fusion. L’hôte décide où les extensions peuvent apparaître et quelles données il partage avec elles.
  • Invité : Votre extension. Il s’agit d’une petite application web que l’hôte charge dans un iframe.

Lors de la création d’une extension d’interface utilisateur, vous ne modifiez pas Fusion. Vous créez et publiez un invité que Fusion peut utiliser une fois l’invité publié.

La technologie sous-jacente

Votre invité repose sur deux technologies Adobe :

  • Adobe App Builder : une plateforme d’hébergement et d’outils gratuite pour les petites applications web et les actions sans serveur. Votre extension est une application App Builder. App Builder vous permet d’héberger votre interface utilisateur (sur le réseau de diffusion de contenu *.adobeio-static.net d’Adobe) et un outil de ligne de commande appelé aio pour la créer, la créer et la publier.
  • SDK d’extensibilité de l’interface utilisateur d’Adobe (UIX) : les bibliothèques qui permettent à l’hôte et à l’invité de parler. Vous n’utiliserez qu’un seul paquet, @adobe/uix-guest, de votre côté. Fusion utilise le package de @adobe/uix-host correspondant sur son côté.

Points d’extension

Un point d’extension est un « slot » nommé dans l’hôte où un invité est autorisé à apparaître. Fusion définit ses créneaux, et vous choisissez celui que l’invité utilisera.

Un nom de point d’extension comporte trois parties : service/name/version.

Fusion offre les points d’extension suivants :

Point d’extension
Emplacement de l’interface utilisateur dans Fusion
Quand l’utiliser
fusion/nav-organization/1
Dans la section Organisation du volet de navigation de gauche.
Votre outil concerne l’ensemble de l’organisation.
fusion/nav-team/1
Sous la section Équipe du volet de navigation de gauche (affiché lorsqu’une équipe est sélectionnée).
Votre outil concerne une équipe spécifique.
  • fusion est le service (le produit, Fusion).
  • nav-organization / nav-team est le nom (emplacement spécifique).
  • 1 est la version.

Une extension peut implémenter un ou deux points d’extension. La plupart des extensions utilisent un point.

En fonction du point d’extension sélectionné, Fusion ajoute un bouton avec le titre de l’extension à la section de navigation correspondante. Cliquez dessus pour ouvrir une page dédiée dans la zone de contenu principale de Fusion et y charger votre interface utilisateur.

Frames inclus dans une extension d’interface utilisateur

IMPORTANT
Cette section aborde un aspect des extensions d’interface utilisateur qui peut prêter à confusion. Nous vous recommandons de le lire attentivement.

Lorsque Fusion charge votre invité, votre extension s’exécute dans deux images :

  1. Cadre d’enregistrement (invisible). S’exécute en premier, en arrière-plan. Le cadre d’enregistrement indique à Fusion ce que votre extension offre. Par exemple, elle peut indiquer qu’elle dispose d’un widget de tableau de bord et envoyer le titre du widget et l’URL de son interface utilisateur. Le cadre d’enregistrement effectue cette opération en appelant register(...). Aucune interface utilisateur n’est visible.
  2. Cadre de l’interface utilisateur (visible). Il s’agit de la page que Fusion présente à l’utilisateur. Il doit s’annoncer auprès de l’hôte en appelant attach(...). S’il n’appelle jamais attach, Fusion attend et finit par s’arrêter avec une erreur.

Cet exemple montre le flux lorsqu’un utilisateur clique sur le bouton de l’extension.

  1. Cliquez sur le bouton.

  2. Fusion charge votre cadre d’ENREGISTREMENT (masqué).

    code language-none 
    register({ methods: { dashboard: { getWidget() {...} } } })

    getWidget() renvoie l’URL de votre interface utilisateur visible

  3. Fusion charge votre cadre d’interface utilisateur (visible) à cette URL.

    code language-none 
    attach({ id })

    Ceci est obligatoire, sinon Fusion expire

  4. Fusion envoie du contexte et votre interface utilisateur s’affiche.

style
shade-box

Les deux cadres sont écrits lorsque vous créez l’interface utilisateur. L’important est de se rappeler que la page visible doit appeler attach.

Pour plus d’informations sur la création de l’interface utilisateur, voir Créer l’interface utilisateur d’extension personnalisée.

Contexte de Fusion

Une fois l’extension attachée, Fusion partage un objet context avec votre invité. Il contient les éléments suivants :

  • Utilisateur : profil Fusion de l’utilisateur connecté et ID utilisateur Adobe IMS.
  • Organisation : enregistrement d’organisation Fusion complet de l’organisation active et ID d’organisation Adobe IMS.
  • Équipe : l’équipe active, le cas échéant.
  • Jeton d’accès Adobe IMS : il appelle les API Adobe ou Fusion au nom de l’utilisateur ou de l’utilisatrice, si nécessaire.

Fusion envoie également des mises à jour. Par exemple, si l’utilisateur change d’organisation ou d’équipe alors que l’interface utilisateur est ouverte, Fusion envoie le nouveau contexte afin que l’interface utilisateur puisse réagir instantanément.

Pour obtenir la liste complète des champs de contexte, voir Référence de contexte de Fusion.

Créer une extension d’interface utilisateur

Pour créer une extension d’interface utilisateur, procédez comme suit :

  1. Installation des outils et création d’un projet Adobe.
  2. Générez un projet App Builder vierge, pointez-le vers un point d’extension Fusion et enregistrez votre widget.
  3. Créer l’interface utilisateur et se connecter à Fusion.
  4. Utilisez le contexte que Fusion envoie.
  5. Publiez pour que Fusion puisse le trouver.
  6. (Facultatif) Appeler les API Workfront/Fusion pour obtenir des données réelles sans CORS.

Pour lancer le processus, accédez à ​ Configuration de vos outils et de votre compte Adobe ​.

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