Como encontrar a ordem correta dos elementos do manifesto
Os elementos XML do manifesto de um Suplemento do Office devem estar no elemento pai apropriado e em uma ordem específica em relação uns aos outros.
A ordem exigida é especificada nos arquivos XSD, na pasta Esquemas. Os arquivos XSD são categorizados em subpastas para suplementos de painel de tarefas, conteúdo e email.
Por exemplo, no <elemento OfficeApp> , a <Id>, <Versão>, <ProviderName> deve aparecer nessa ordem. Se um <elemento AlternateId> for adicionado, ele deve estar entre o <elemento Id> e <Version> . Se algum dos elementos estiver na posição incorreta, o manifesto não será válido e o suplemento não será carregado.
Observação
O validador dentro do office-addin-manifest usa a mesma mensagem de erro quando um elemento está fora de ordem como quando um elemento está sob o pai errado. A mensagem de erro informa que o elemento não é um elemento filho válido do elemento pai. Caso receba este erro, mas a documentação de referência do elemento filho indique que ele está válido para o pai, talvez o problema seja o filho ter sido colocado na ordem incorreta.
As seções a seguir mostram os elementos de manifesto na ordem em que devem ser exibidos. Há diferenças dependendo se o type atributo do <elemento OfficeApp> é TaskPaneApp, ContentAppou MailApp. Para impedir que essas seções se tornem muito desajeitadas, o elemento VersionOverrides> altamente complexo< é dividido em seções separadas.
Observação
Nem todos os elementos mostrados são obrigatórios. Se o minOccurs valor de um elemento for 0 no esquema, o elemento será opcional.
Ordenação de elemento de suplemento do painel de tarefas básico
<OfficeApp xsi:type="TaskPaneApp">
<Id>
<AlternateID>
<Version>
<ProviderName>
<DefaultLocale>
<DisplayName>
<Override>
<Description>
<Override>
<IconUrl>
<Override>
<HighResolutionIconUrl>
<Override>
<SupportUrl>
<AppDomains>
<AppDomain>
<Hosts>
<Host>
<Requirements>
<Sets>
<Set>
<Methods>
<Method>
<DefaultSettings>
<SourceLocation>
<Override>
<Permissions>
<Dictionary>
<TargetDialects>
<QueryUri>
<CitationText>
<DictionaryName>
<DictionaryHomePage>
<VersionOverrides>*
<ExtendedOverrides>
*Consulte Ordenação de elemento de suplemento do painel de tarefas em VersionOverrides para a ordenação de elementos filhos de VersionOverrides.
Ordenação de elemento de suplemento de email básico
<OfficeApp xsi:type="MailApp">
<Id>
<AlternateId>
<Version>
<ProviderName>
<DefaultLocale>
<DisplayName>
<Override>
<Description>
<Override>
<IconUrl>
<Override>
<HighResolutionIconUrl>
<Override>
<SupportUrl>
<AppDomains>
<AppDomain>
<Hosts>
<Host>
<Requirements>
<Sets>
<Set>
<FormSettings>
<Form>
<DesktopSettings>
<SourceLocation>
<RequestedHeight>
<TabletSettings>
<SourceLocation>
<RequestedHeight>
<PhoneSettings>
<SourceLocation>
<Permissions>
<Rule>
<DisableEntityHighlighting>
<VersionOverrides>*
*Consulte Ordenação de elemento de suplemento de email em VersionOverrides Ver. 1.0 e ordenação de elemento de suplemento de email no VersionOverrides Ver. 1.1 para a ordenação de elementos filhos de VersionOverrides.
Ordenação de elemento de suplemento de conteúdo básico
<OfficeApp xsi:type="ContentApp">
<Id>
<AlternateId>
<Version>
<ProviderName>
<DefaultLocale>
<DisplayName>
<Override>
<Description>
<Override>
<IconUrl >
<Override>
<HighResolutionIconUrl>
<Override>
<SupportUrl>
<AppDomains>
<AppDomain>
<Hosts>
<Host>
<Requirements>
<Sets>
<Set>
<Methods>
<Method>
<DefaultSettings>
<SourceLocation>
<Override>
<RequestedWidth>
<RequestedHeight>
<Permissions>
<AllowSnapshot>
<VersionOverrides>*
*Consulte Ordenação de elemento de suplemento de conteúdo no VersionOverrides para a ordenação de elementos filhos de VersionOverrides.
Ordenação de elemento de suplemento do painel de tarefas em VersionOverrides
<VersionOverrides>
<Description>
<Requirements>
<Sets>
<Set>
<Hosts>
<Host>
<Runtimes>
<Runtime>
<AllFormFactors>
<ExtensionPoint>
<Script>
<SourceLocation>
<Page>
<SourceLocation>
<Metadata>
<SourceLocation>
<Namespace>
<DesktopFormFactor>
<GetStarted>
<Title>
<Description>
<LearnMoreUrl>
<FunctionFile>
<ExtensionPoint>
<OfficeTab>
<Group>
<Label>
<Icon>
<Image>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Enabled>
<Items>
<Item>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<CustomTab>
<Group> (can be below <ControlGroup>)
<OverriddenByRibbonApi>
<Label>
<Icon>
<Image>
<Control>
<OverriddenByRibbonApi>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Enabled>
<Items>
<Item>
<OverriddenByRibbonApi>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<ControlGroup> (can be above <Group>)
<Label>
<InsertAfter> (or <InsertBefore>)
<OfficeMenu>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Enabled>
<Items>
<Item>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Resources>
<Images>
<Image>
<Override>
<Urls>
<Url>
<Override>
<ShortStrings>
<String>
<Override>
<LongStrings>
<String>
<Override>
<WebApplicationInfo>
<Id>
<Resource>
<Scopes>
<Scope>
<EquivalentAddins>
<EquivalentAddin>
<ProgId>
<DisplayName>
<FileName>
<Type>
Ordenação de elemento de suplemento por email no VersionOverrides Ver. 1.0
<VersionOverrides>
<Description>
<Requirements>
<Sets>
<Set>
<Hosts>
<Host>
<DesktopFormFactor>
<ExtensionPoint>
<OfficeTab>
<Group>
<Label>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<SourceLocation>
<FunctionName>
<CustomTab>
<Group>
<Label>
<Icon>
<Image>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Items>
<Item>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Label>
<OfficeMenu>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Items>
<Item>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Resources>
<Images>
<Image>
<Override>
<Urls>
<Url>
<Override>
<ShortStrings>
<String>
<Override>
<LongStrings>
<String>
<Override>
<VersionOverrides>*
* Um VersionOverrides com type valor VersionOverridesV1_1, em vez de VersionOverridesV1_0, pode ser aninhado no final dos VersionOverrides externos. Consulte Ordenação de elemento de suplemento de email no VersionOverrides Ver. 1.1 para obter a ordenação de elementos no VersionOverridesV1_1.
Ordenação de elemento de suplemento por email no VersionOverrides Ver. 1.1
<VersionOverrides>
<Description>
<Requirements>
<Sets>
<Set>
<Hosts>
<Host>
<DesktopFormFactor>
<ExtensionPoint>
<OfficeTab>
<Group>
<Label>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<SourceLocation>
<FunctionName>
<CustomTab>
<Group>
<Label>
<Icon>
<Image>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Items>
<Item>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Label>
<OfficeMenu>
<Control>
<Label>
<Supertip>
<Title>
<Description>
<Icon>
<Image>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<Items>
<Item>
<Label>
<Supertip>
<Title>
<Description>
<Action>
<TaskpaneId>
<SourceLocation>
<Title>
<FunctionName>
<SourceLocation>
<Label>
<CommandSurface>
<MobileFormFactor>
<ExtensionPoint>
<Group>
<Label>
<Control>
<Label>
<Icon>
<Image>
<Action>
<SourceLocation>
<FunctionName>
<Control>
<Label>
<Icon>
<Image>
<Action>
<SourceLocation>
<FunctionName>
<Resources>
<Images>
<Image>
<Override>
<Urls>
<Url>
<Override>
<ShortStrings>
<String>
<Override>
<LongStrings>
<String>
<Override>
<WebApplicationInfo>
<Id>
<Resource>
<Scopes>
<Scope>
Ordenação de elemento de suplemento de conteúdo em VersionOverrides
<VersionOverrides>
<WebApplicationInfo>
<Id>
<Resource>
<Scopes>
<Scope>
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de