Как определить правильный порядок элементов манифеста
XML-элементы в манифесте надстройки Office должны располагаться под правильным родительском элементом и в определенном порядке относительно друг друга под родительским элементом.
Нужный порядок указывается в XSD-файлах в папке Schemas. XSD-файлы упорядочены в подпапках для области задач, контента и почтовых надстроек.
Например, в элементе <OfficeApp> в этом порядке должны отображаться идентификаторы> Id, Version, ProviderName.<<><> При добавлении <элемента AlternateId> он должен находиться между элементами< Id> и <Version>. Ваш манифест будет недопустимым и надстройка не загрузится, если любой из элементов находится в неправильном порядке.
Примечание.
Проверяющий элемент в манифесте office-addin-manifest использует то же сообщение об ошибке, когда элемент находится в неправильном расположении. В сообщении об ошибке указывается, что для родительского элемента этот дочерний элемент не является допустимым. Если появляется такая ошибка, но при этом в справочной документации указано, что дочерний элемент является допустимым для родительского, значит проблема вероятно связана с тем, что дочерний элемент помещен в неправильном порядке.
В следующих разделах показаны элементы манифеста в том порядке, в котором они должны отображаться. Существуют различия в зависимости от того, является TaskPaneApp
ли type
атрибут <элемента OfficeApp> , или ContentApp
MailApp
. Чтобы эти разделы не стали слишком громоздкими, сложный <элемент VersionOverrides> разбивается на отдельные разделы.
Примечание.
Не все отображаемые элементы являются обязательными.
minOccurs
Если значение элемента в схеме равно 0, элемент является необязательным.
Простое упорядочение элементов надстройки области задач
<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>
Базовый порядок элементов почтовой надстройки
<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>*
*Сведения о порядке дочерних элементов VersionOverrides см . в разделе Порядок элементов надстройки Mail в VersionOverrides версии 1.0 и упорядочение элементов почтовой надстройки в VersionOverrides Версии 1.1 .
Упорядочение элементов надстройки базового содержимого
<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>*
*См . упорядочение элементов надстройки содержимого в VersionOverrides для упорядочения дочерних элементов VersionOverrides.
Упорядочение элементов надстройки области задач в 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 <OfficeGroup>)
<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>
<OfficeGroup> (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>
Упорядочение элементов надстройки почты в 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>*
* Объект VersionOverrides со type
значением VersionOverridesV1_1
вместо VersionOverridesV1_0
может быть вложен в конец внешнего объекта VersionOverrides. Порядок элементов в см. в разделе Упорядочение элементов почтовой надстройки вVersionOverridesV1_1
VersionOverrides версии 1.1.
Упорядочение элементов надстройки почты в VersionOverrides Ver. 1.1
<VersionOverrides>
<Description>
<Requirements>
<Sets>
<Set>
<Hosts>
<Host>
<DesktopFormFactor>
<ExtensionPoint>
<OfficeTab>
<Group>
<Label>
<Tooltip>
<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>
Упорядочение элементов надстройки содержимого в VersionOverrides
<VersionOverrides>
<WebApplicationInfo>
<Id>
<Resource>
<Scopes>
<Scope>
См. также
Office Add-ins