VersionOverrides 1.1 element in the manifest file for a mail add-in (Elemento VersionOverrides 1.1 no ficheiro de manifesto de um suplemento de correio)

  • Artigo

Este elemento contém informações para funcionalidades que não são suportadas no manifesto base.

Observação

Este artigo pressupõe que está familiarizado com a descriçã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 apenas nestes esquemas VersionOverrides:

  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

  • Caixa de correio 1.5
  • Alguns elementos subordinados podem estar associados a conjuntos de requisitos adicionais.

Elementos filho

A tabela seguinte aplica-se apenas à versão 1.1 dos <elementos VersionOverrides> e apenas aos suplementos de correio.

Observação

No iOS, só <é suportado WebApplicationInfo> . Todos os outros elementos subordinados 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 têm de ser suportados para que a marcação nas VersionOverrides principais<> entre em vigor. Deve ser sempre mais restritivo do que o <elemento Requisitos> na parte base do manifesto.
Hosts Sim Especifica uma coleção de aplicações do Office. O elemento Anfitriões subordinados substitui o elemento Anfitriões na parte principal 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 Web. O suplemento Web não será ativado se estiver instalado um suplemento nativo equivalente.
<VersionOverrides> Não Não é atualmente utilizável em VersionOverrides 1.1 para suplementos de correio.
WebApplicationInfo Não Especifica detalhes sobre o registo do suplemento com emissores de tokens seguros, como o Azure Active Directory V2.0.
ExtendedPermissions Não Especifica uma coleção de permissões expandidas.

Descrição

Descreve o suplemento. Isto substitui o <elemento Descrição> em qualquer parte principal 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 Descrição> não pode ter mais de 32 carateres e tem de corresponder ao valor do id atributo de um elemento subordinado do <elemento ShortString> contido no elemento Resources .

Tipo de suplemento: Painel de tarefas, Correio

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Exemplo

Apresentamos um exemplo simples a seguir. Para obter exemplos mais complexos, veja os manifestos dos suplementos de exemplo nos exemplos de código do Suplemento do Office.

Segue-se um exemplo de um elemento VersionOverrides> típico<, incluindo alguns elementos subordinados que não são necessários, mas que normalmente são utilizados.

<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 teria um aspeto semelhante ao seguinte exemplo.

<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>