Share via

Elemento VersionOverrides 1.0 no arquivo de manifesto para um suplemento de email

  • Artigo

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.

Associado a esses conjuntos de requisitos:

  • Caixa de correio 1.3
  • Alguns elementos filho podem estar associados a conjuntos de requisitos adicionais.

Elementos filho

A tabela a seguir se aplica apenas à versão 1.0 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.
<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 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:

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 dar suporte opcionalmente a novos recursos em um esquema mais recente, ao mesmo tempo em que dá suporte a clientes mais antigos que não dão suporte aos novos recursos.

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