VersionOverrides 1.0 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.0

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.3
  • Alguns elementos filho podem ser associados a conjuntos de requisitos adicionais.

Elementos filho

A tabela a seguir se aplica somente à versão 1.0 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.
<VersionOverrides> Não Define comandos de suplemento em uma versão mais recente do esquema. Para saber mais, confira o tópico Implementar várias versões.
WebApplicationInfo Não Especifica detalhes sobre o registro do suplemento com emissores de token seguros, como o Azure Active Directory V2.0.

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.

<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>
...
</OfficeApp>

Implementar várias versões

Um manifesto pode implementar várias versões do <elemento VersionOverrides que dão suporte a diferentes versões do esquema VersionOverrides> . Isso pode ser feito para, opcionalmente, dar suporte a novos recursos em um esquema mais recente e, ao mesmo tempo, dar suporte a clientes mais antigos que não oferecem suporte aos novos recursos.

Para implementar várias versões, o <elemento VersionOverrides> para a versão mais recente deve ser um filho do VersionOverrides elemento para a versão mais antiga. O elemento filho< VersionOverrides> não herda nenhum valor do 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