次の方法で共有

マニフェストの拡張オーバーライドを操作する

  • [アーティクル]

アドインで XML 形式のアドインのみのマニフェストを使用する場合、Office アドインの一部の機能拡張機能は、アドインのマニフェストではなく、サーバーでホストされている JSON ファイルで構成されます。

注:

この記事では、Office アドイン マニフェストとそのアドインでの役割について理解していることを前提としています。最近使用していない場合 は、「Office アドイン マニフェスト」を参照してください。

次の表は、拡張オーバーライドを必要とする機能拡張機能と、その機能のドキュメントへのリンクを示しています。

機能 開発手順
キーボード ショートカット Office アドインにカスタム キーボード ショートカットを追加する

JSON 形式を定義するスキーマは、 拡張マニフェスト スキーマです。

ヒント

この記事はやや抽象的です。 概念を明確にするために、表のいずれかの記事を読むことを検討してください。

JSON ファイルの場所を Office に伝える

マニフェストを使用して、JSON ファイルの場所を Office に伝えます。 マニフェスト内の <VersionOverrides> 要素の直下 (内部ではない) に、ExtendedOverrides 要素を追加します。 Url属性を JSON ファイルの完全な URL に設定します。 次に、最も簡単な<ExtendedOverrides> 要素の例を示します。

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json"></ExtendedOverrides>
</OfficeApp>

次に、非常に単純な拡張オーバーライド JSON ファイルの例を示します。 アドインの作業ウィンドウを開く関数 (他の場所で定義) に、キーボード ショートカット Ctrl + Shift + A を割り当てます。

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "Show task pane for add-in"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "CTRL+SHIFT+A"
            }
        }
    ]
}

拡張オーバーライド ファイルをローカライズする

アドインで複数のロケールがサポートされている場合は、<ExtendedOverrides> 要素の ResourceUrl 属性を使用して、ローカライズされたリソースのファイルを Office にポイントできます。 次に例を示します。

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

リソース ファイルを作成して使用する方法、拡張オーバーライド ファイルでそのリソースを参照する方法、およびここで説明していないその他のオプションの詳細については、「 拡張オーバーライドをローカライズする」を参照してください。