Trabalhar com Substituições Expandidas do manifesto

  • Artigo

Quando o seu suplemento utiliza o manifesto apenas de suplemento com formato XML, algumas funcionalidades de extensibilidade dos Suplementos do Office são configuradas com ficheiros JSON alojados no seu servidor, em vez de com o manifesto do suplemento.

Observação

Este artigo pressupõe que está familiarizado com os manifestos de Suplementos do Office e a respetiva função nos suplementos. Leia o manifesto de Suplementos do Office, se ainda não o fez recentemente.

A tabela seguinte especifica as funcionalidades de extensibilidade que requerem uma substituição expandida, juntamente com ligações para a documentação da funcionalidade.

Recurso Instruções de Desenvolvimento
Atalhos de teclado Adicionar atalhos de teclado personalizados aos seus Suplementos do Office

O esquema que define o formato JSON é o esquema extended-manifest.

Dica

Este artigo é um pouco abstrato. Considere ler um dos artigos na tabela para aumentar a clareza dos conceitos.

Indicar ao Office onde encontrar o ficheiro JSON

Utilize o manifesto para indicar ao Office onde encontrar o ficheiro JSON. Imediatamente abaixo (não dentro) do <elemento VersionOverrides> no manifesto, adicione um elemento ExtendedOverrides . Defina o Url atributo como o URL completo de um ficheiro JSON. Segue-se um exemplo do elemento ExtendedOverrides> mais simples possível<.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json"></ExtendedOverrides>
</OfficeApp>

Segue-se um exemplo de um ficheiro JSON expandido muito simples. Atribui o atalho de teclado CTRL+SHIFT+A a uma função (definida noutro local) que abre o painel de tarefas do suplemento.

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "Show task pane for add-in"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "CTRL+SHIFT+A"
            }
        }
    ]
}

Localizar o ficheiro de substituições expandidas

Se o seu suplemento suportar várias regiões, pode utilizar o ResourceUrl atributo do elemento ExtendedOverrides> para apontar o< Office para um ficheiro de recursos localizados. Apresentamos um exemplo a seguir.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

Para obter mais detalhes sobre como criar e utilizar o ficheiro de recursos, como fazer referência aos respetivos recursos no ficheiro de substituições expandidas e para obter opções adicionais não abordadas aqui, consulte Localizar substituições expandidas.