Partager via

Élément Action

  • Article

Spécifie l’action à effectuer lorsque l’utilisateur sélectionne un contrôle Button ou Menu .

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0
  • Mail 1.0
  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Attributs

Attribut Obligatoire Description
xsi:type Oui Type d’action à effectuer

xsi:type

Cet attribut indique le type d’action réalisée lorsque l’utilisateur sélectionne le bouton. Il peut s’agir de l’une des actions suivantes :

  • ExecuteFunction
  • ShowTaskpane

Une fois que l’utilisateur sélectionne un bouton qui lance l’action ExecuteFunction , le complément expire au bout de 5 minutes s’il n’est pas terminé avant cette date.

Importante

Outlook : l’inscription des événements de boîte aux lettres et d’élément n’est pas disponible lorsque xsi :type a la valeur ExecuteFunction.

Éléments enfants

Éléments enfants valides très en fonction de la valeur du xsi:type paramètre .

xsi :type est ExecuteFunction

Élément Description
FunctionName Spécifie le nom de la fonction à exécuter.

FunctionName

Élément obligatoire lorsque xsi :type a la valeur ExecuteFunction. Indique le nom de la fonction à exécuter. La fonction est contenue dans le fichier indiqué dans l’élément FunctionFile.

<Action xsi:type="ExecuteFunction">
  <FunctionName>getSubject</FunctionName>
</Action>

xsi :type est ShowTaskpane

Élément Description
SourceLocation Spécifie l’emplacement du fichier source pour cette action.
  TaskpaneId Spécifie l’ID du conteneur de volet des tâches. Non pris en charge dans les compléments Outlook.
  Titre Indique le titre personnalisé du volet Office. Non pris en charge dans les compléments Outlook.
  SupportsPinning Indique qu’un volet des tâches prend en charge l’épinglage, ce qui conserve le volet des tâches ouvert lorsque l’utilisateur modifie la sélection. Pris en charge dans Outlook uniquement.
SupportsMultiselect Spécifie qu’un complément Outlook peut s’activer sur plusieurs messages sélectionnés. Pris en charge dans Outlook uniquement.
SupportsNoItemContext Spécifie qu’un complément Outlook peut s’activer sans que le volet de lecture soit activé ou qu’un message soit sélectionné. Pris en charge dans les clients de bureau Outlook uniquement.

SourceLocation

Élément obligatoire lorsque xsi :type a la valeur ShowTaskpane. Spécifie l’emplacement du fichier source pour cette action. L’attribut resid ne peut pas comporter plus de 32 caractères et doit être défini sur la valeur de l’attribut id d’un <élément Url> dans l’élément <Urls> de l’élément Resources .

<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
</Action>

TaskpaneId

Élément facultatif lorsque xsi :type a la valeur ShowTaskpane. Spécifie l’ID du conteneur de volet des tâches. Lorsque vous avez plusieurs ShowTaskpane actions, utilisez un TaskpaneId> différent< si vous souhaitez un volet indépendant pour chacune d’elles. Utilisez le même <TaskpaneId> pour différentes actions qui partagent le même volet. Lorsque les utilisateurs choisissent des commandes qui partagent le même <TaskpaneId>, le conteneur de volet reste ouvert, mais le contenu du volet est remplacé par l’Action SourceLocationcorrespondante.

Type de complément : volet Office

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Remarque

Cet élément n’est pas pris en charge dans Outlook.

L’exemple suivant montre deux actions qui partagent le même <TaskpaneId>.

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="aTaskPaneUrl" />
</Action>

<Action xsi:type="ShowTaskpane">
  <TaskpaneId>MyPane</TaskpaneId>
  <SourceLocation resid="anotherTaskPaneUrl" />
</Action>

Les exemples suivants montrent deux actions qui utilisent un TaskpaneId> différent<. Pour voir ces exemples en contexte, consultez Exemple de commandes de complément simple.

<Action xsi:type="ShowTaskpane">
   <TaskpaneId>MyTaskPaneID1</TaskpaneId>
   <SourceLocation resid="Contoso.Taskpane1.Url" />
</Action>

<Action xsi:type="ShowTaskpane">
   <TaskpaneId>MyTaskPaneID2</TaskpaneId>
   <SourceLocation resid="Contoso.Taskpane2.Url" />
</Action>

<bt:Urls>
   <bt:Url id="Contoso.Taskpane1.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane.html" />
   <bt:Url id="Contoso.Taskpane2.Url" DefaultValue="https://commandsimple.azurewebsites.net/Taskpane2.html" />
</bt:Urls>

Titre

Élément facultatif lorsque xsi :type a la valeur ShowTaskpane. Indique le titre personnalisé du volet Office pour cette action.

Type de complément : volet Office

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Remarque

Cet élément enfant n’est pas pris en charge dans les compléments Outlook.

L’exemple suivant montre une action qui utilise l’élément <Title> . Notez que vous n’attribuez pas directement le <titre> à une chaîne. Au lieu de cela, vous lui affectez un ID de ressource (resid), qui est défini dans la <section Ressources> du manifeste et ne peut pas comporter plus de 32 caractères.

<Action xsi:type="ShowTaskpane">
    <TaskpaneId>Office.AutoShowTaskpaneWithDocument</TaskpaneId>
    <SourceLocation resid="PG.Code.Url" />
    <Title resid="PG.CodeCommand.Title" />
</Action>

 ... Other markup omitted ...
<Resources>
    <bt:Images> ...
    </bt:Images>
    <bt:Urls>
        <bt:Url id="PG.Code.Url" DefaultValue="https://localhost:3000?commands=1" />
    </bt:Urls>
    <bt:ShortStrings>
        <bt:String id="PG.CodeCommand.Title" DefaultValue="Code" />
    </bt:ShortStrings>
 ... Other markup omitted ...
</Resources>

SupportsPinning

Élément facultatif lorsque xsi :type a la valeur ShowTaskpane. Les éléments VersionOverrides contenant doivent avoir une valeur d’attribut xsi :type de VersionOverridesV1_1. Incluez cet élément avec une valeur true pour prendre en charge l’épinglage du volet Office. L’utilisateur pourra alors « épingler » le volet Office qui restera ouvert pendant que la sélection est modifiée. Pour en savoir plus, consultez l’article relatif à l’implémentation d’un volet Office épinglable dans Outlook.

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Importante

Bien que l’élément SupportsPinning ait été introduit dans l’ensemble de conditions requises 1.5, il est actuellement pris en charge uniquement pour les abonnés Microsoft 365 à l’aide des éléments suivants :

  • Outlook moderne sur le web
  • nouvel Outlook sur Windows
  • Outlook 2016 ou version ultérieure sur Windows (build 7628.1000 ou ultérieure)
  • Outlook sur Mac (build 16.13.503 ou ultérieure)
<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SupportsMultiselect

Élément facultatif dans les compléments Outlook lorsque xsi :type a la valeur ShowTaskpane. Incluez la valeur pour permettre à un complément d’activer true et d’effectuer des opérations spécifiques sur plusieurs messages sélectionnés. Étant donné que la sélection multiple d’élément s’applique uniquement aux messages, la valeur de l’attribut xsi :type de l’élément ExtensionPoint doit être définie sur MessageReadCommandSurface ou MessageComposeCommandSurface. Pour en savoir plus sur la sélection multiple d’éléments, voir Activer votre complément Outlook sur plusieurs messages.

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskpaneUrl" />
    <SupportsMultiSelect>true</SupportsMultiSelect>
</Action>

SupportsNoItemContext

Élément facultatif dans les compléments Outlook lorsque xsi :type a la valeur ShowTaskpane. Incluez la valeur pour permettre à un complément de true s’activer sans que le volet de lecture soit activé ou qu’un message soit sélectionné. Si <SupportsNoItemContext> a la valeur true, la valeur de l’attribut xsi :type de l’élément ExtensionPoint doit être définie sur MessageReadCommandSurface. Pour plus d’informations, voir Activer votre complément Outlook sans que le volet de lecture soit activé ou qu’un message soit sélectionné.

Type de complément : messagerie

Valide uniquement dans les schémas VersionOverrides suivants :

  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

Remarque

Bien qu’Outlook sur le web et les nouveaux Outlook sur Windows prennent en charge l’ensemble de conditions requises pour les boîtes aux lettres 1.13, un complément ne s’active pas si le volet de lecture est masqué ou si un message n’est pas sélectionné pour la première fois. Pour plus d’informations, consultez Prise en charge des fonctionnalités dans Outlook sur le web et Nouvelle version d’Outlook sur Windows.

<Action xsi:type="ShowTaskpane">
    <SourceLocation resid="Taskpane.Url"/>
    <SupportsNoItemContext>true</SupportsNoItemContext>
</Action>