VersionOverrides elemento 1.0 no ficheiro de manifesto de um suplemento de correio

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

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

Elementos filho

A tabela seguinte aplica-se apenas à versão 1.0 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.
<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 registo do suplemento com emissores de tokens seguros, como o Azure Active Directory V2.0.

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:

• AddinCommands 1.1 quando versionOverrides principal< é o> tipo Taskpane 1.0.
• Caixa de correio 1.3 quando o VersionOverrides> principal< é do tipo Correio 1.0.
• Caixa de correio 1.5 quando o VersionOverrides> principal< é do tipo Correio 1.1.

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.

<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 suportam versões diferentes do esquema VersionOverrides. Isto pode ser feito para suportar opcionalmente novas funcionalidades num esquema mais recente, ao mesmo tempo que suporta clientes mais antigos que não suportam as novas funcionalidades.

Para implementar várias versões, o <elemento VersionOverrides> para a versão mais recente tem de ser subordinado do VersionOverrides elemento para a versão mais antiga. O elemento child< VersionOverrides> não herda quaisquer valores do elemento principal.

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>