Outlook 加载项功能区按钮未显示
Outlook Add-in ribbon button not showing
背景
我正在为 Outlook 开发 Office 插件。我正在尝试向应该打开 TaskPane 的功能区添加一个按钮。我在我的清单中定义了功能区按钮,在 XML:
的 <Control>
块下
<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="MailApp">
<Id>1bf213f9-65a5-4395-aef8-239d72c7e509</Id>
<Version>1.0.0.0</Version>
<ProviderName>myProviderName</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<DisplayName DefaultValue="myDisplayName" />
<Description DefaultValue="myDescription"/>
<Hosts>
<Host Name="Mailbox" />
</Hosts>
<Requirements>
<Sets>
<Set Name="MailBox" MinVersion="1.1" />
</Sets>
</Requirements>
<FormSettings>
<Form xsi:type="ItemEdit">
<DesktopSettings>
<SourceLocation DefaultValue="https://hiddenurl/app/index.html" />
</DesktopSettings>
</Form>
</FormSettings>
<Permissions>ReadWriteItem</Permissions>
<Rule xsi:type="RuleCollection" Mode="Or">
<Rule xsi:type="ItemIs" FormType="Edit" ItemType="Message"/>
</Rule>
<DisableEntityHighlighting>false</DisableEntityHighlighting>
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides"
xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0"
xsi:type="VersionOverridesV1_0">
<Hosts>
<Host xsi:type="MailHost">
<DesktopFormFactor>
<ExtensionPoint xsi:type="MessageComposeCommandSurface">
<OfficeTab id="TabDefault">
<Group id="mainGroup">
<Label resid="groupLabel"/>
<Tooltip resid="groupsTooltip"/>
<Control xsi:type="Button" id="button">
<Label resid="buttonLabel"/>
<Tooltip resid="buttonTooltip"/>
<Supertip>
<Title resid="superTipTitle"/>
<Description resid="superTipDescription"/>
</Supertip>
<Icon>
<bt:Image size="16" resid="icon16"/>
<bt:Image size="32" resid="icon32"/>
<bt:Image size="80" resid="icon80"/>
</Icon>
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="taskPaneUrl" />
</Action>
</Control>
</Group>
</OfficeTab>
</ExtensionPoint>
</DesktopFormFactor>
</Host>
</Hosts>
<Resources>
<bt:Images>
<bt:Image id="icon16" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
<bt:Image id="icon32" DefaultValue="https://hiddenurl/assets/icons/icon_32.png" />
<bt:Image id="icon80" DefaultValue="https://hiddenurl/assets/icons/icon_80.png" />
</bt:Images>
<bt:Urls>
<bt:Url id="taskPaneUrl" DefaultValue="https://hiddenurl/app/index.html" />
</bt:Urls>
<bt:ShortStrings>
<bt:String id="tabLabel" DefaultValue="tabLabel" />
<bt:String id="groupLabel" DefaultValue="groupLabel" />
<bt:String id="groupsTooltip" DefaultValue="groupsTooltip" />
<bt:String id="buttonLabel" DefaultValue="buttonLabel" />
<bt:String id="buttonTooltip" DefaultValue="buttonTooltip" />
<bt:String id="superTipTitle" DefaultValue="superTipTitle" />
<bt:String id="superTipDescription" DefaultValue="superTipDescription" />
</bt:ShortStrings>
</Resources>
</VersionOverrides>
</OfficeApp>
我希望在功能区上看到一个带有我的徽标的按钮,我应该可以单击它来打开任务窗格。但是我看不到任何按钮,在 Office 加载项/我的加载项下,我的加载项甚至没有显示。
我试过的
如果我删除清单中的整个 <VersionOverrides>
块,加载项将再次显示在 Office 加载项/我的加载项下,我可以通过那里访问我的 TaskPane。
我尝试遵循这些示例但没有成功:
问题
- 我的清单文件可能有什么问题?
- 如何验证清单文件声明功能区按钮是否正确?
- 如何验证我的清单文件是否正确?
您的资源部分格式不正确。请更新到以下内容,一切都会按您的要求工作...
<Resources>
<bt:Images>
<bt:Image id="icon16" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
<bt:Image id="icon32" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
<bt:Image id="icon80" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
</bt:Images>
<bt:Urls>
<bt:Url id="taskPaneUrl" DefaultValue="https://hiddenurl/app/index.html" />
</bt:Urls>
<bt:ShortStrings>
<bt:String id="tabLabel" DefaultValue="tabLabel" />
<bt:String id="groupLabel" DefaultValue="groupLabel" />
<bt:String id="buttonLabel" DefaultValue="buttonLabel" />
<bt:String id="superTipTitle" DefaultValue="superTipTitle" />
</bt:ShortStrings>
<bt:LongStrings>
<bt:String id="buttonTooltip" DefaultValue="buttonTooltip" />
<bt:String id="groupsTooltip" DefaultValue="groupsTooltip" />
<bt:String id="superTipDescription" DefaultValue="superTipDescription" />
</bt:LongStrings>
</Resources>
您应该将 "IconUrl" 和 "HighResolutionIconUrl" 添加到 "OfficeApp" 部分以支持对 "VersionOverridesV1_0" 一无所知的客户。这两个节点应该在 "Description" 之后。如果您将来要将您的应用程序提交到 Office Store,您将需要在 "HighResolutionIconUrl" 之后添加 "SupportUrl" 节点。
请记住,清单文件中的所有内容都严格按照方案进行,并且应该是有效的。
背景
我正在为 Outlook 开发 Office 插件。我正在尝试向应该打开 TaskPane 的功能区添加一个按钮。我在我的清单中定义了功能区按钮,在 XML:
的<Control>
块下
<?xml version="1.0" encoding="UTF-8"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="MailApp">
<Id>1bf213f9-65a5-4395-aef8-239d72c7e509</Id>
<Version>1.0.0.0</Version>
<ProviderName>myProviderName</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<DisplayName DefaultValue="myDisplayName" />
<Description DefaultValue="myDescription"/>
<Hosts>
<Host Name="Mailbox" />
</Hosts>
<Requirements>
<Sets>
<Set Name="MailBox" MinVersion="1.1" />
</Sets>
</Requirements>
<FormSettings>
<Form xsi:type="ItemEdit">
<DesktopSettings>
<SourceLocation DefaultValue="https://hiddenurl/app/index.html" />
</DesktopSettings>
</Form>
</FormSettings>
<Permissions>ReadWriteItem</Permissions>
<Rule xsi:type="RuleCollection" Mode="Or">
<Rule xsi:type="ItemIs" FormType="Edit" ItemType="Message"/>
</Rule>
<DisableEntityHighlighting>false</DisableEntityHighlighting>
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides"
xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0"
xsi:type="VersionOverridesV1_0">
<Hosts>
<Host xsi:type="MailHost">
<DesktopFormFactor>
<ExtensionPoint xsi:type="MessageComposeCommandSurface">
<OfficeTab id="TabDefault">
<Group id="mainGroup">
<Label resid="groupLabel"/>
<Tooltip resid="groupsTooltip"/>
<Control xsi:type="Button" id="button">
<Label resid="buttonLabel"/>
<Tooltip resid="buttonTooltip"/>
<Supertip>
<Title resid="superTipTitle"/>
<Description resid="superTipDescription"/>
</Supertip>
<Icon>
<bt:Image size="16" resid="icon16"/>
<bt:Image size="32" resid="icon32"/>
<bt:Image size="80" resid="icon80"/>
</Icon>
<Action xsi:type="ShowTaskpane">
<SourceLocation resid="taskPaneUrl" />
</Action>
</Control>
</Group>
</OfficeTab>
</ExtensionPoint>
</DesktopFormFactor>
</Host>
</Hosts>
<Resources>
<bt:Images>
<bt:Image id="icon16" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
<bt:Image id="icon32" DefaultValue="https://hiddenurl/assets/icons/icon_32.png" />
<bt:Image id="icon80" DefaultValue="https://hiddenurl/assets/icons/icon_80.png" />
</bt:Images>
<bt:Urls>
<bt:Url id="taskPaneUrl" DefaultValue="https://hiddenurl/app/index.html" />
</bt:Urls>
<bt:ShortStrings>
<bt:String id="tabLabel" DefaultValue="tabLabel" />
<bt:String id="groupLabel" DefaultValue="groupLabel" />
<bt:String id="groupsTooltip" DefaultValue="groupsTooltip" />
<bt:String id="buttonLabel" DefaultValue="buttonLabel" />
<bt:String id="buttonTooltip" DefaultValue="buttonTooltip" />
<bt:String id="superTipTitle" DefaultValue="superTipTitle" />
<bt:String id="superTipDescription" DefaultValue="superTipDescription" />
</bt:ShortStrings>
</Resources>
</VersionOverrides>
</OfficeApp>
我希望在功能区上看到一个带有我的徽标的按钮,我应该可以单击它来打开任务窗格。但是我看不到任何按钮,在 Office 加载项/我的加载项下,我的加载项甚至没有显示。
我试过的
如果我删除清单中的整个 <VersionOverrides>
块,加载项将再次显示在 Office 加载项/我的加载项下,我可以通过那里访问我的 TaskPane。
我尝试遵循这些示例但没有成功:
问题
- 我的清单文件可能有什么问题?
- 如何验证清单文件声明功能区按钮是否正确?
- 如何验证我的清单文件是否正确?
您的资源部分格式不正确。请更新到以下内容,一切都会按您的要求工作...
<Resources>
<bt:Images>
<bt:Image id="icon16" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
<bt:Image id="icon32" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
<bt:Image id="icon80" DefaultValue="https://hiddenurl/assets/icons/icon_16.png" />
</bt:Images>
<bt:Urls>
<bt:Url id="taskPaneUrl" DefaultValue="https://hiddenurl/app/index.html" />
</bt:Urls>
<bt:ShortStrings>
<bt:String id="tabLabel" DefaultValue="tabLabel" />
<bt:String id="groupLabel" DefaultValue="groupLabel" />
<bt:String id="buttonLabel" DefaultValue="buttonLabel" />
<bt:String id="superTipTitle" DefaultValue="superTipTitle" />
</bt:ShortStrings>
<bt:LongStrings>
<bt:String id="buttonTooltip" DefaultValue="buttonTooltip" />
<bt:String id="groupsTooltip" DefaultValue="groupsTooltip" />
<bt:String id="superTipDescription" DefaultValue="superTipDescription" />
</bt:LongStrings>
</Resources>
您应该将 "IconUrl" 和 "HighResolutionIconUrl" 添加到 "OfficeApp" 部分以支持对 "VersionOverridesV1_0" 一无所知的客户。这两个节点应该在 "Description" 之后。如果您将来要将您的应用程序提交到 Office Store,您将需要在 "HighResolutionIconUrl" 之后添加 "SupportUrl" 节点。
请记住,清单文件中的所有内容都严格按照方案进行,并且应该是有效的。