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

Office アドインの機能拡張機能の一部は、アドインの XML マニフェストではなく、サーバーでホストされている 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>

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