VersionOverrides 1.1 no arquivo de manifesto de 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 somente do suplemento.

Associado a estes conjuntos de requisitos:

  • Caixa de correio 1.5
  • Alguns elementos filho podem ser associados a conjuntos de requisitos adicionais.

Elementos filho

A tabela a seguir se aplica somente à versão 1.1 dos elementos VersionOverrides<> e somente aos suplementos de email.

Observação

No iOS, apenas <WebApplicationInfo> tem suporte. 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 suportados para que a marcação no VersionOverrides> pai< entre em vigor. Isso sempre deve ser mais restritivo do que o <elemento Requirements> na parte base do manifesto.
Hosts Não Especifica uma coleção de aplicativos do Office. O elemento Hosts filho substitui o elemento Hosts na parte pai do manifesto.
Recursos Não 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 No momento, não pode ser usado 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 id valor do 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 somente do suplemento.

Associado a estes conjuntos de requisitos:

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.

Veja a seguir um exemplo de um elemento VersionOverrides típico<, incluindo alguns elementos filho que não são obrigató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>
  • Last updated on