Elemento VersionOverrides 1.1 no arquivo de manifesto para um suplemento de email
Esse elemento contém informações para recursos que não têm suporte no manifesto base.
Observação
Este artigo pressupõe que você esteja familiarizado com a visão geral do elemento VersionOverrides, que contém informações importantes sobre os atributos e variações do elemento.
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.
Associado a esses conjuntos de requisitos:
- Caixa de correio 1.5
- Alguns elementos filho podem estar associados a conjuntos de requisitos adicionais.
Elementos filho
A tabela a seguir se aplica apenas à versão 1.1 dos <elementos VersionOverrides> e somente aos suplementos de email.
Observação
No iOS, há suporte apenas <para WebApplicationInfo> . Todos os outros elementos filho de <VersionOverrides são ignorados> .
Elemento | Obrigatório | Descrição |
---|---|---|
Descrição | Não | Descreve o suplemento. |
Requisitos | Não | Especifica os conjuntos de requisitos mínimos que devem ser compatíveis para que a marcação no VersionOverrides> pai< entre em vigor. Isso sempre deve ser mais restritivo do que o <elemento Requisitos> na parte base do manifesto. |
Hosts | Sim | Especifica uma coleção de aplicativos do Office. O elemento Hosts filho substitui o elemento Hosts na parte pai do manifesto. |
Recursos | Sim | Define um conjunto de recursos (cadeias de caracteres, URLs e imagens) consultado por outros elementos do manifesto. |
EquivalentAddins | Não | Especifica os suplementos nativos (COM/XLL) que são equivalentes ao suplemento da Web. O suplemento da Web não será ativado se um suplemento nativo equivalente estiver instalado. |
<VersionOverrides> | Não | Atualmente não é utilizável em VersionOverrides 1.1 para suplementos de email. |
WebApplicationInfo | Não | Especifica detalhes sobre o registro do suplemento com emissores de token seguros, como o Azure Active Directory V2.0. |
ExtendedPermissions | Não | Especifica uma coleção de permissões estendidas. |
Descrição
Descreve o suplemento. Isso substitui o <elemento Description> em qualquer parte pai do manifesto. O texto da descrição está contido em um elemento filho do elemento LongString, contido no elemento Resources. O resid
atributo do <elemento Description> não pode ter mais de 32 caracteres e deve corresponder ao valor do id
atributo de um elemento filho do <elemento ShortString> contido no elemento Resources .
Tipo de suplemento: Painel de tarefas, Email
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.
Associado a esses conjuntos de requisitos:
- AddinCommands 1.1 quando o VersionOverrides> pai< é tipo Taskpane 1.0.
- Caixa de correio 1.3 quando o VersionOverrides> pai< é tipo Email 1.0.
- Caixa de correio 1.5 quando o VersionOverrides> pai< é tipo Email 1.1.
Exemplo
Apresentamos um exemplo simples a seguir. Para obter exemplos mais complexos, consulte os manifestos dos suplementos de exemplo em exemplos de código de suplemento do Office.
A seguir está um exemplo de um elemento VersionOverrides típico<, incluindo alguns elementos> filho que não são necessários, mas normalmente são usados.
<OfficeApp ... xsi:type="MailApp">
...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
<Description resid="residDescription" />
<Requirements>
<!-- add information on requirements -->
</Requirements>
<Hosts>
<Host xsi:type="MailHost">
<!-- add information on form factors -->
</Host>
</Hosts>
<Resources>
<!-- add information on resources -->
</Resources>
</VersionOverrides>
...
</OfficeApp>
Implementar várias versões
Um manifesto pode implementar várias versões do elemento VersionOverrides
que é compatível com várias versões do esquema VersionOverrides. Isso pode ser feito para fornecer suporte opcional a novos recursos em um esquema mais recente, sem deixar de fornecer suporte a clientes antigos que não têm suporte para os novos recursos.
Para implementar várias versões, o elemento VersionOverrides
da versão mais recente deve ser um filho do elemento VersionOverrides
da versão anterior. O elemento filho VersionOverrides
não herda os valores do elemento pai.
Para implementar o esquema VersionOverrides v1.0 e v1.1, o manifesto seria semelhante ao exemplo a seguir.
<OfficeApp ... xsi:type="MailApp">
...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
<Description resid="residDescription" />
<Requirements>
<!-- add information on requirements -->
</Requirements>
<Hosts>
<Host xsi:type="MailHost">
<!-- add information on form factors -->
</Host>
</Hosts>
<Resources>
<!-- add information on resources -->
</Resources>
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
<Description resid="residDescription" />
<Requirements>
<!-- add information on requirements -->
</Requirements>
<Hosts>
<Host xsi:type="MailHost">
<!-- add information on form factors -->
</Host>
</Hosts>
<Resources>
<!-- add information on resources -->
</Resources>
</VersionOverrides>
</VersionOverrides>
...
</OfficeApp>
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de