Elemento Action

Especifica a ação a ser executada quando o usuário seleciona um botão ou controle de menu .

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado 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

Depois que o usuário seleciona um botão que inicia a ExecuteFunction ação, o suplemento atinge o tempo limite após cinco minutos se ainda não tiver sido concluído.

Importante

Outlook: Registro Mailbox e Itemeventos não está disponível quando xsi:type é ExecuteFunction.

Elementos filho

Os elementos filho 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 ser executada.

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. O valor especificado no <elemento FunctionName> deve corresponder ao valor passado para o actionId parâmetro da chamada Office.actions.associate no arquivo que contém a função. Isso garante que a função correta seja invocada quando o botão ou o controle de item de menu for selecionado. Para saber mais, consulte Criar comandos de suplemento com o manifesto somente do suplemento.

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

xsi:type is 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. Sem suporte em suplementos do Outlook.
  Título Especifica o título personalizado do painel de tarefas. Sem suporte em 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. Com suporte apenas no Outlook.
SuportaSeleção múltipla Especifica que um suplemento do Outlook pode ser ativado em várias mensagens selecionadas. Com suporte apenas no Outlook.
SupportsNoItemContext Especifica que um suplemento do Outlook pode ser ativado sem o Painel de Leitura habilitado ou sem uma mensagem selecionada. Com suporte apenas em clientes da área 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 caracteres e deve ser definido como 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 você tiver várias ShowTaskpane ações, use um TaskpaneId> diferente< se quiser um painel independente para cada uma. Use o mesmo <TaskpaneId> para ações diferentes que compartilham o mesmo painel. Quando os usuários escolhem comandos que compartilham o mesmo <TaskpaneId>, o contêiner do painel permanecerá aberto, mas o conteúdo do painel será substituído pela ação SourceLocationcorrespondente.

Tipo de suplemento: Painel de tarefas

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado a estes conjuntos de requisitos:

Observação

Esse elemento não tem suporte no Outlook.

O exemplo a seguir mostra duas ações que compartilham 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 a seguir mostram duas ações que usam um TaskpaneId> diferente<. Para ver esses exemplos no contexto, consulte 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 somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado a estes conjuntos de requisitos:

Observação

Esse elemento filho não tem suporte em suplementos do Outlook.

O exemplo a seguir mostra uma ação que usa o <elemento Title> . Observe que você não atribui o <Título> a uma cadeia de caracteres diretamente. Em vez disso, você atribui a ele uma ID de recurso (resid), que é definida na seção Resources> do manifesto< e não pode ter mais 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 quando xsi:type é ShowTaskpane. Os elementos VersionOverrides que contêm devem 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 somente nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado a estes conjuntos de requisitos:

Importante

Embora o elemento SupportsPinning tenha sido introduzido no conjunto de requisitos 1.5, atualmente ele só tem suporte para assinantes do Microsoft 365 usando o seguinte:

  • Outlook na Web moderno
  • novo Outlook no Windows
  • Outlook 2016 ou posterior no Windows (versão 1612 (build 7628.1000) ou posterior)
  • Outlook no Mac (Versão 16.13 (18050300) ou posterior)
<Action xsi:type="ShowTaskpane">
  <SourceLocation resid="readTaskPaneUrl" />
  <SupportsPinning>true</SupportsPinning>
</Action>

SuportaSeleção múltipla

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. Como a seleção múltipla de item só se aplica a mensagens, o valor do atributo xsi:type do elemento ExtensionPoint deve ser definido como MessageReadCommandSurface ou MessageComposeCommandSurface. Para saber mais sobre a seleção múltipla de itens, consulte Ativar seu suplemento do Outlook em várias mensagens.

Tipo de suplemento: Email

Válido somente nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado 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 que um suplemento seja ativado sem o Painel de true Leitura habilitado ou uma mensagem selecionada. Se <SupportsNoItemContext> estiver definido como true, o valor do atributo xsi:type do elemento ExtensionPoint deverá ser definido como MessageReadCommandSurface. Para saber mais, consulte Ativar seu suplemento do Outlook sem o Painel de Leitura habilitado ou uma mensagem selecionada.

Tipo de suplemento: Email

Válido somente nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado a estes conjuntos de requisitos:

Observação

Embora o Outlook na Web e o novo Outlook no Windows deem suporte ao requisito de caixa de correio definido 1.13, um suplemento não será ativado se o Painel de Leitura estiver oculto ou se uma mensagem não for selecionada primeiro. Para saber mais, consulte Suporte a recursos no Outlook na Web e novo Outlook no Windows.

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