Implementar um painel de tarefas fixável no Outlook

A forma de experiência do usuário do painel de tarefas para comandos de suplemento abre um painel de tarefas vertical à direita de uma mensagem aberta ou solicitação de reunião. Isso permite que um suplemento forneça interface do usuário para interações mais detalhadas, como o preenchimento de vários campos de texto. Esse painel de tarefas pode ser mostrado no Painel de Leitura ao exibir uma lista de mensagens, permitindo o processamento rápido de uma mensagem.

No entanto, por padrão, se um usuário tiver um painel de tarefas do suplemento aberto para uma mensagem no Painel de Leitura e selecionar uma nova mensagem, o painel de tarefas será fechado automaticamente. Para um suplemento bastante usado, o usuário pode optar por manter esse painel aberto, eliminando a necessidade de reativar o suplemento em cada mensagem. Com painéis de tarefas fixáveis, seu suplemento pode dar ao usuário essa opção.

Modos do Outlook com suporte

Os painéis de tarefas fixáveis têm suporte nos modos de Compose de Mensagens e de Leitura de Mensagens no Outlook. No entanto, a fixação não é compatível com modos diferentes. Isso ocorre porque um suplemento pode ter interfaces de usuário diferentes para botões e painéis de tarefas em cada modo. Por exemplo, se um usuário fixar o painel de tarefas de um suplemento durante a leitura de uma mensagem e, em seguida, criar uma nova mensagem, ele não verá o painel de tarefas do suplemento a partir da mensagem que está redigindo. Para exibir o painel de tarefas, o usuário deve ativar o suplemento a partir da mensagem que está redigindo. Se o usuário fixar o painel de tarefas, o painel de tarefas permanecerá fixado na próxima vez que o usuário redigir outra mensagem.

Suporte para fixação do painel de tarefas

A primeira etapa consiste em adicionar o suporte para fixação no manifesto do suplemento. A marcação varia de acordo com o tipo de manifesto que seu suplemento usa.

"actions": [
    {
        "id": "OpenTaskPane",
        "type": "openPage",
        "view": "TaskPaneView",
        "pinnable": true
    }
]

<!-- Task pane button. -->
<Control xsi:type="Button" id="msgReadOpenPaneButton">
  <Label resid="paneReadButtonLabel" />
  <Supertip>
    <Title resid="paneReadSuperTipTitle" />
    <Description resid="paneReadSuperTipDescription" />
  </Supertip>
  <Icon>
    <bt:Image size="16" resid="green-icon-16" />
    <bt:Image size="32" resid="green-icon-32" />
    <bt:Image size="80" resid="green-icon-80" />
  </Icon>
  <Action xsi:type="ShowTaskpane">
    <SourceLocation resid="readTaskPaneUrl" />
    <SupportsPinning>true</SupportsPinning>
  </Action>
</Control>

Atualizações de tratamento da interface do usuário com base na mensagem atualmente selecionada

Para atualizar a interface do usuário ou as variáveis internas do painel de tarefas com base no item atual, você deve registrar um manipulador de eventos para receber notificações das alterações.

Implementar o manipulador de eventos

O manipulador de eventos deve aceitar um parâmetro exclusivo, que é um objeto literal. A propriedade type desse objeto será definida como Office.EventType.ItemChanged. Ao chamar o evento, o objeto Office.context.mailbox.item já estará atualizado para refletir o item atualmente selecionado.

function itemChanged(eventArgs) {
  // Update UI based on the new current item.
  updateTaskPaneUI(Office.context.mailbox.item);
}

// Example implementation.
function updateTaskPaneUI(item) {
  // Assuming that item is always a read item (instead of a compose item).
  if (item != null) console.log(item.subject);
}

Registrar o manipulador de eventos

Use o método Office.context.mailbox.addHandlerAsync para registrar o manipulador de eventos para o evento Office.EventType.ItemChanged. Isso deve ser feito na Office.onReady função do painel de tarefas.

Office.onReady(() => {
  $(document).ready(() => {
    // Set up the ItemChanged event.
    Office.context.mailbox.addHandlerAsync(Office.EventType.ItemChanged, itemChanged);
    updateTaskPaneUI(Office.context.mailbox.item);
  });
});

Fixação do painel de tarefas em seleção múltipla

Quando você seleciona vários itens de email e inicia o painel de tarefas do suplemento de seleção múltipla, o comportamento de fixação do painel de tarefas varia dependendo do cliente Outlook.

• Mac: o painel de tarefas permanece aberto mesmo quando um usuário alterna para um item de email diferente. O painel de tarefas só pode ser fechado selecionando o botão Fechar no painel de tarefas.
• Windows (novo e clássico) e Web: o painel de tarefas não fica aberto quando o usuário alterna para um novo item. Para manter o painel de tarefas aberto, selecione o ícone de fixar no painel de tarefas.

Implantar para usuários

Se você planeja publicar seu suplemento do Outlook no Microsoft Marketplace e ele está configurado com um painel de tarefas fixável, o conteúdo fixado do suplemento não deve ser estático. Ou seja, o conteúdo fixado deve mudar dependendo da mensagem ou compromisso que está aberto ou selecionado no momento na caixa de correio. Isso garante que o suplemento passará na validação do Microsoft Marketplace.

Confira também

• Ativar seu suplemento do Outlook em várias mensagens
• Ativar o suplemento do Outlook sem o Painel de Leitura habilitado ou sem uma mensagem selecionada