Compartilhar via

Elemento Action

  • Artigo

Especifica a ação a executar quando o utilizador seleciona um controlo Botão ou Menu .

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Atributos

Atributo Obrigatório Descrição
xsi:type Sim Tipo de ação a executar

xsi:type

Este atributo especifica o tipo de ação realizada quando o usuário seleciona o botão. Pode ser uma das seguintes:

  • ExecuteFunction
  • ShowTaskpane

Quando o utilizador seleciona um botão que inicia a ação ExecuteFunction , o suplemento excede o tempo limite após 5 minutos, caso ainda não tenha sido concluído.

Importante

Outlook: o registo de eventos de Caixa de Correio e Item não está disponível quando xsi:type é ExecuteFunction.

Elementos filho

Os elementos subordinados válidos dependem muito do valor do xsi:type parâmetro .

xsi:type é ExecuteFunction

Elemento Descrição
FunctionName Especifica o nome da função a executar.

FunctionName

Elemento necessário quando xsi:type é ExecuteFunction. Especifica o nome da função a ser executada. A função está contida no arquivo especificado no elemento FunctionFile.

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

xsi:type é ShowTaskpane

Elemento Descrição
SourceLocation Especifica o local do arquivo de origem para essa ação.
  TaskpaneId Especifica a ID do contêiner do painel de tarefas. Não suportado nos suplementos do Outlook.
  Título Especifica o título personalizado do painel de tarefas. Não suportado nos suplementos do Outlook.
  SupportsPinning Especifica se um painel de tarefas tem suporte para fixação, que mantém o painel de tarefas aberto quando o usuário altera a seleção. Suportado apenas no Outlook.
SupportsMultiselect Especifica que um suplemento do Outlook pode ser ativado em várias mensagens selecionadas. Suportado apenas no Outlook.
SupportsNoItemContext Especifica que um suplemento do Outlook pode ser ativado sem o Painel de Leitura ativado ou uma mensagem selecionada. Suportado apenas em clientes de ambiente de trabalho do Outlook.

SourceLocation

Elemento necessário quando xsi:type é ShowTaskpane. Especifica o local do arquivo de origem para essa ação. O atributo resid não pode ter mais de 32 carateres e tem de ser definido para o valor do atributo ID de um <elemento url> no <elemento URLs> no elemento Resources .

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

TaskpaneId

Elemento opcional quando xsi:type é ShowTaskpane. Especifica a ID do contêiner do painel de tarefas. Quando tiver várias ShowTaskpane ações, utilize um TaskpaneId> diferente< se quiser um painel independente para cada uma. Utilize o mesmo <TaskpaneId> para diferentes ações que partilham o mesmo painel. Quando os utilizadores escolherem comandos que partilham o mesmo <TaskpaneId>, o contentor do painel permanecerá aberto, mas os conteúdos do painel serão substituídos pela Ação SourceLocationcorrespondente.

Tipo de suplemento: Painel de tarefas

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Observação

Esse elemento não tem suporte no Outlook.

O exemplo seguinte mostra duas ações que partilham o mesmo <TaskpaneId>.

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

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

Os exemplos seguintes mostram duas ações que utilizam um TaskpaneId> diferente<. Para ver estes exemplos em contexto, veja Simple Add-in Commands Sample (Exemplo de Comandos de Suplemento Simples).

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

Título

Elemento opcional quando xsi:type é ShowTaskpane. Especifica o título personalizado do painel de tarefas desta ação.

Tipo de suplemento: Painel de tarefas

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Observação

Este elemento subordinado não é suportado nos suplementos do Outlook.

O exemplo seguinte mostra uma ação que utiliza o <elemento Título> . Tenha em atenção que não atribui o <Título> a uma cadeia diretamente. Em vez disso, atribua-lhe um ID de recurso (residir), que é definido na <secção Recursos> do manifesto e não pode ter mais de 32 carateres.

<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 quando xsi:type é ShowTaskpane. Os elementos que contêm VersionOverrides têm de ter um valor de atributo xsi:type de VersionOverridesV1_1. Inclua esse elemento com um valor true a fim de fornecer suporte para fixação do painel de tarefas. O usuário pode "fixar" o painel de tarefas, fazendo com que ele permaneça aberto quando alterar a seleção. Para saber mais, consulte Implementar um painel de tarefas fixável no Outlook.

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Importante

Embora o elemento SupportsPinning tenha sido introduzido no conjunto de requisitos 1.5, atualmente só é suportado para subscritores do Microsoft 365 com o seguinte:

  • Outlook na Web moderno
  • novo Outlook no Windows
  • Outlook 2016 ou posterior no Windows (compilação 7628.1000 ou posterior)
  • Outlook para Mac (compilação 16.13.503 ou posterior)
<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SupportsMultiselect

Elemento opcional nos suplementos do Outlook quando xsi:type é ShowTaskpane. Inclua um valor de true para permitir que um suplemento ative e execute operações específicas em várias mensagens selecionadas. Uma vez que a seleção múltipla do item só se aplica a mensagens, o valor do atributo xsi:type do elemento ExtensionPoint tem de ser definido como MessageReadCommandSurface ou MessageComposeCommandSurface. Para saber mais sobre a seleção múltipla de itens, consulte Ativar o seu suplemento do Outlook em várias mensagens.

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

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

SupportsNoItemContext

Elemento opcional nos suplementos do Outlook quando xsi:type é ShowTaskpane. Inclua um valor de para permitir a ativação de true um suplemento sem o Painel de Leitura ativado ou uma mensagem selecionada. Se <SupportsNoItemContext> estiver definido como true, o valor do atributo xsi:type do elemento ExtensionPoint tem de ser definido como MessageReadCommandSurface. Para saber mais, consulte Ativar o seu suplemento do Outlook sem o Painel de Leitura ativado ou uma mensagem selecionada.

Tipo de suplemento: Email

Válido apenas nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Observação

Embora o Outlook na Web e o novo Outlook no Windows suportem o requisito de Caixa de Correio definido como 1.13, um suplemento não será ativado se o Painel de Leitura estiver oculto ou uma mensagem não estiver selecionada pela primeira vez. Para saber mais, consulte Suporte de funcionalidades no Outlook na Web e o novo Outlook no Windows.

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