Partager via

Ouvrir automatiquement un volet Office lors de l’installation d’un complément

  • Article

Vous pouvez configurer le volet Office de votre complément pour qu’il soit lancé immédiatement après son installation. Cette fonctionnalité augmente l’utilisation.

Par défaut, les compléments du volet Office qui n’incluent aucunecommande de complément ouvrent le volet Office immédiatement après l’installation. Toutefois, lorsqu’un complément a une ou plusieurs commandes de complément, l’utilisateur est averti du nouveau complément, mais le complément ne se lance pas automatiquement. Ce comportement historique par défaut change, de sorte que les compléments qui ont des commandes de complément se lancent automatiquement dans certaines situations. En outre, si le complément comporte plusieurs pages de volet office, il est possible de contrôler si le complément démarre lors de l’installation et, le cas échéant, quelle page s’ouvre dans le volet Office.

Remarque

  • Cette fonctionnalité s’applique uniquement aux compléments installés par un utilisateur final, et non aux compléments déployés de manière centralisée.
  • Cette fonctionnalité ne s’applique pas aux compléments de contenu ou aux compléments courrier (Outlook).
  • Cette fonctionnalité s’applique uniquement aux compléments qui ont au moins une commande de complément de type « commande du volet Office ».

Nouveau comportement

Le nouveau comportement est le suivant :

  • Si le complément n’a qu’une seule commande du volet Office, l’onglet du ruban du complément est sélectionné et le volet Office s’ouvre automatiquement lors de l’installation. Vous n’avez rien à configurer.
  • Si le complément a plusieurs commandes du volet Office et que l’une d’elles est configurée pour être la commande par défaut (voir Configurer le volet Office par défaut), l’onglet du ruban du complément est sélectionné et le volet Office par défaut s’ouvre automatiquement lors de l’installation.
  • Si le complément a plusieurs commandes du volet Office, mais qu’aucune n’est configurée pour être la valeur par défaut, l’onglet du ruban du complément est automatiquement sélectionné lors de l’installation et une légende s’affiche à proximité pour avertir l’utilisateur du nouveau complément, mais aucun volet Office n’est ouvert. Il s’agit du même comportement que le comportement par défaut historique.

Remarque

Si, pour une raison quelconque, la commande de complément qui lance le volet Office ne peut pas être sélectionnée manuellement par un utilisateur au démarrage, par exemple lorsqu’elle est configurée pour être désactivée au démarrage, elle ne sera pas automatiquement ouverte, quelle que soit la configuration.

Configurer le volet Office par défaut dans le manifeste

Le processus de spécification du volet Office par défaut dépend du type de manifeste utilisé par le complément.

Remarque

Le manifeste unifié pour Microsoft 365 peut être utilisé dans les compléments Outlook de production. Il est disponible uniquement en préversion pour les compléments Excel, PowerPoint et Word.

Pour spécifier le volet Office par défaut, recherchez l’objet runtime dans le tableau « runtimes » dont la propriété « code.page » est définie sur l’URL de la page par défaut. Vérifiez que le tableau « actions » de ce même objet runtime comporte au moins une action dont la valeur « type » est « openPage ». Ajoutez une propriété « view » à cet objet d’action et définissez-la sur « Office.AutoShowTaskpaneWithDocument ». Vous ne pouvez définir cette valeur que sur un seul objet d’action et il doit s’agir d’une action de type « openPage ». Si vous définissez cette valeur sur plusieurs actions, la première occurrence de la valeur est reconnue comme valeur par défaut et les autres sont ignorées.

L’exemple suivant montre une valeur « view » définie sur « Office.AutoShowTaskpaneWithDocument ».

"runtimes": [
    {
        ...
        "code": {
            "page": "https://contoso.com/taskpane.html"
        },
        "actions": [
            {
                "id": "ShowTaskPane",
                "type": "openPage",
                "view": "Office.AutoShowTaskpaneWithDocument"
            }
        ]
    }
]

Conseil

Si vous souhaitez que votre complément se lance automatiquement chaque fois que l’utilisateur rouvre le document, vous devez effectuer d’autres étapes de configuration. Pour plus d’informations et des conseils sur l’utilisation de cette fonctionnalité, consultez Ouvrir automatiquement un volet Office avec un document.

Voir aussi