Partilhar via


Abrir automaticamente um painel de tarefas quando um suplemento é instalado

Pode configurar o painel de tarefas do suplemento para iniciar imediatamente após a instalação. Esta funcionalidade aumenta a utilização.

Por predefinição, os suplementos do painel de tarefas que não incluem quaisquer comandos de suplementos abrem o painel de tarefas imediatamente após a instalação. No entanto, quando um suplemento tem um ou mais comandos de suplemento, o utilizador é notificado do novo suplemento, mas o suplemento não é iniciado automaticamente. Este comportamento predefinido histórico está a mudar, pelo que os suplementos com comandos de suplementos serão iniciados automaticamente em algumas situações. Além disso, se o suplemento tiver mais do que uma página do painel de tarefas, é possível controlar se o suplemento é iniciado após a instalação e, em caso afirmativo, que página é aberta no painel de tarefas.

Observação

  • Esta funcionalidade aplica-se apenas a suplementos instalados por um utilizador final e não a suplementos implementados centralmente.
  • Esta funcionalidade não se aplica a suplementos de Conteúdo ou suplementos de Correio (Outlook).
  • Esta funcionalidade aplica-se apenas a suplementos que tenham, pelo menos, um comando de suplemento do tipo "comando do painel de tarefas".

Novo comportamento

O novo comportamento é o seguinte:

  • Se o suplemento tiver apenas um comando do painel de tarefas, o separador do friso do suplemento é selecionado e o painel de tarefas é aberto automaticamente após a instalação. Não precisa de configurar nada.
  • Se o suplemento tiver vários comandos do painel de tarefas e um estiver configurado para ser a predefinição (consulte Configurar o painel de tarefas predefinido), o separador do friso do suplemento é selecionado e o painel de tarefas predefinido é aberto automaticamente após a instalação.
  • Se o suplemento tiver vários comandos do painel de tarefas, mas nenhum estiver configurado para ser a predefinição, o separador do friso do suplemento é selecionado automaticamente após a instalação e é apresentada uma nota de aviso perto de notificar o utilizador do novo suplemento, mas não é aberto nenhum painel de tarefas. Isto é o mesmo que o comportamento predefinido histórico.

Observação

Se, por algum motivo, o comando de suplemento que inicia o painel de tarefas não puder ser selecionado manualmente por um utilizador no arranque, como quando está configurado para ser desativado no arranque, não será aberto automaticamente independentemente da configuração.

Configurar o painel de tarefas predefinido no manifesto

O processo para especificar o painel de tarefas predefinido depende do tipo de manifesto que o suplemento utiliza.

Observação

O manifesto unificado do Microsoft 365 pode ser utilizado nos suplementos de produção do Outlook. Está disponível apenas como uma pré-visualização para suplementos do Excel, PowerPoint e Word.

Para especificar o painel de tarefas predefinido, localize o objeto de runtime na matriz "runtimes" cuja propriedade "code.page" está definida como o URL da página que pretende que seja a predefinição. Certifique-se de que a matriz "actions" neste mesmo objeto de runtime tem, pelo menos, uma ação cujo valor de "tipo" é "openPage". Adicione uma propriedade "view" a este objeto de ação e defina-a como "Office.AutoShowTaskpaneWithDocument". Só pode definir este valor num objeto de ação e tem de ser uma ação do tipo "openPage". Se definir este valor em múltiplas ações, a primeira ocorrência do valor será reconhecida como a predefinição e as outras serão ignoradas.

O exemplo seguinte mostra um valor "view" definido como "Office.AutoShowTaskpaneWithDocument".

"runtimes": [
    {
        ...
        "code": {
            "page": "https://contoso.com/taskpane.html"
        },
        "actions": [
            {
                "id": "ShowTaskPane",
                "type": "openPage",
                "view": "Office.AutoShowTaskpaneWithDocument"
            }
        ]
    }
]

Dica

Se quiser que o seu suplemento seja iniciado automaticamente sempre que o utilizador reabrir o documento, terá de efetuar mais passos de configuração. Para obter detalhes e conselhos sobre quando utilizar esta funcionalidade, consulte Abrir automaticamente um painel de tarefas com um documento.

Confira também