Compartir a través de

Elemento Action

  • Artículo

Especifica la acción que se va a realizar cuando el usuario selecciona un control Botón o Menú .

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0
  • Correo 1.0
  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

  • AddinCommands 1.1 cuando el elemento primario< VersionOverrides> es de tipo Panel de tareas 1.0.
  • Buzón 1.3 cuando el elemento primario< VersionOverrides> es de tipo Mail 1.0.
  • Buzón 1.5 cuando el elemento primario< VersionOverrides> es de tipo Mail 1.1.

Atributos

Atributo Obligatorio Descripción
xsi:type Sí Tipo de acción que se va a realizar

xsi:type

Este atributo especifica el tipo de acción que se realiza cuando el usuario selecciona el botón. Puede ser uno de las siguientes:

  • ExecuteFunction
  • ShowTaskpane

Una vez que el usuario selecciona un botón que inicia la ExecuteFunction acción, el complemento agota el tiempo de espera después de 5 minutos si no se ha completado para entonces.

Importante

Outlook: el registro de eventos de buzón y elemento no está disponible cuando xsi:type es ExecuteFunction.

Elementos secundarios

Los elementos secundarios válidos dependen en gran parte del valor del xsi:type parámetro .

xsi:type es ExecuteFunction

Elemento Descripción
FunctionName Especifica el nombre de la función que se va a ejecutar.

FunctionName

Elemento obligatorio cuando xsi:type es ExecuteFunction. Especifica el nombre de la función que se va a ejecutar. La función está incluida en el archivo especificado en el elemento FunctionFile.

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

xsi:type es ShowTaskpane

Elemento Descripción
SourceLocation Especifica la ubicación del archivo de origen para esta acción.
  TaskpaneId Especifica el ID del contenedor del panel de tareas. No se admite en complementos de Outlook.
  Title Especifica el título personalizado del panel de tareas. No se admite en complementos de Outlook.
  SupportsPinning Especifica que un panel de tareas admite el anclado, lo que provoca que el panel de tareas siga abierto aunque el usuario cambie la selección. Solo se admite en Outlook.
SupportsMultiselect Especifica que un complemento de Outlook puede activarse en varios mensajes seleccionados. Solo se admite en Outlook.
SupportsNoItemContext Especifica que un complemento de Outlook puede activarse sin el panel de lectura habilitado o un mensaje seleccionado. Solo se admite en clientes de escritorio de Outlook.

SourceLocation

Elemento obligatorio cuando xsi:type es ShowTaskpane. Especifica la ubicación del archivo de origen para esta acción. El atributo resid no puede tener más de 32 caracteres y debe establecerse en el valor del atributo id de un <elemento Url> en el <elemento Urls> del elemento Resources .

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

TaskpaneId

Elemento opcional cuando xsi:type es ShowTaskpane. Especifica el ID del contenedor del panel de tareas. Cuando tenga varias ShowTaskpane acciones, use un TaskpaneId> diferente< si desea un panel independiente para cada una. Use el mismo <TaskpaneId> para diferentes acciones que comparten el mismo panel. Cuando los usuarios eligen comandos que comparten el mismo <TaskpaneId>, el contenedor del panel permanecerá abierto, pero el contenido del panel se reemplazará por la acción SourceLocationcorrespondiente.

Tipo de complemento: Panel de tareas

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

Nota:

Este elemento no es compatible con Outlook.

En el ejemplo siguiente se muestran dos acciones que comparten el mismo <TaskpaneId>.

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

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

En los ejemplos siguientes se muestran dos acciones que usan un TaskpaneId> diferente<. Para ver estos ejemplos en contexto, vea Ejemplo de comandos de complemento 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>

Cargo

Elemento opcional cuando xsi:type es ShowTaskpane. Especifica el título personalizado del panel de tareas de esta acción.

Tipo de complemento: Panel de tareas

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

Nota:

Este elemento secundario no se admite en los complementos de Outlook.

En el ejemplo siguiente se muestra una acción que usa el <elemento Title> . Tenga en cuenta que no asigna el <título> a una cadena directamente. En su lugar, se le asigna un identificador de recurso (resid), que se define en la <sección Recursos> del manifiesto y no puede tener más de 32 caracteres.

<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

Elemento opcional cuando xsi:type es ShowTaskpane. Los elementos VersionOverrides que contienen deben tener un valor de atributo xsi:type de VersionOverridesV1_1. Incluya este elemento con el valor true para admitir el anclado de paneles de tareas. El usuario podrá “anclar” el panel de tareas, lo que hará que permanezca abierto cuando se cambie la selección. Para obtener más información, consulte Implementar un panel de tareas anclable en Outlook.

Tipo de complemento: correo

Solo es válido en estos esquemas VersionOverrides:

  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

Importante

Aunque el elemento SupportsPinning se introdujo en el conjunto de requisitos 1.5, actualmente solo se admite para los suscriptores de Microsoft 365 mediante lo siguiente:

  • Outlook en la Web (versión moderna)
  • nuevo Outlook en Windows
  • Outlook 2016 o posterior en Windows (versión 1612 (compilación 7628.1000) o posterior)
  • Outlook en Mac (versión 16.13 (18050300) o posterior)
<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SupportsMultiselect

Elemento opcional en complementos de Outlook cuando xsi:type es ShowTaskpane. Incluya un valor de true para permitir que un complemento active y realice operaciones específicas en varios mensajes seleccionados. Dado que la selección múltiple de elementos solo se aplica a los mensajes, el valor del atributo xsi:type del elemento ExtensionPoint debe establecerse en MessageReadCommandSurface o MessageComposeCommandSurface. Para obtener más información sobre la selección múltiple de elementos, vea Activar el complemento de Outlook en varios mensajes.

Tipo de complemento: correo

Solo es válido en estos esquemas VersionOverrides:

  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

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

SupportsNoItemContext

Elemento opcional en complementos de Outlook cuando xsi:type es ShowTaskpane. Incluya un valor de true para permitir que un complemento se active sin el panel de lectura habilitado o un mensaje seleccionado. Si <SupportsNoItemContext> está establecido en true, el valor del atributo xsi:type del elemento ExtensionPoint debe establecerse en MessageReadCommandSurface. Para obtener más información, vea Activar el complemento de Outlook sin el panel de lectura habilitado o un mensaje seleccionado.

Tipo de complemento: correo

Solo es válido en estos esquemas VersionOverrides:

  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociado a estos conjuntos de requisitos:

Nota:

Aunque Outlook en la Web y el nuevo outlook en Windows admiten el conjunto de requisitos de buzón 1.13, un complemento no se activará si el panel de lectura está oculto o no se selecciona primero un mensaje. Para obtener más información, consulte Compatibilidad con características en Outlook en la Web y nueva Outlook en Windows.

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