Office アドインを更新して管理する

アドインを発行した後は、アップストリーム ライブラリからの重要な変更を最新の状態に保つ必要があります。 セキュリティの問題に修正プログラムを適用することは、顧客の信頼を構築するために重要です。 これらの変更は発行されたマニフェストに影響しないため、顧客はアドインの最新バージョンを取得するためのアクションを実行する必要はありません。

シナリオを選択する

Office.js の破壊的変更

API サーフェスと動作に重大な変更を加えないように努めています。 ただし、セキュリティや信頼性のために破壊的な更新を行う必要がある場合があります。 まれなケースでは、アドインのユーザーが影響を受けないように、次の手順を実行します。

非推奨ポリシー

より適切なツールが利用可能になると、ツールが非推奨になる可能性があります。また、一般提供 (GA) である Office JavaScript ライブラリ (Office.js) の API は、新しい API でタスクが適切に実行されると非推奨になる可能性があります。 Microsoft では、少なくとも 24 か月前に非推奨を宣言するよう最善を尽くしています。 非推奨は、必ずしも機能または API が削除され、開発者が使用できないことを意味するものではありません。 ただし、24 か月後、Microsoft はツールまたは API をサポートしなくなり 、ツールが 廃止され、API が GA バージョンの Office.js から削除 される可能性があります 。

API が非推奨としてマークされている場合は、できるだけ早く代替 API に移行することを強くお勧めします。 場合によっては、元の API が非推奨になった直後に、新しいアプリケーションが新しい API の使用を開始する必要があることをお知らせします。 そのような場合、現在非推奨 APIを使用しているアクティブなアプリケーションのみが使用し続けることができます。

重要

24 か月間の非推奨期間は、その長い待ち時間がアドインまたは Microsoft のセキュリティ リスクをもたらす場合に加速されます。

App Assure

Microsoft の App Assure サービスは、アプリケーションの互換性に関する Microsoft の約束を果たします。アプリは Windows とMicrosoft 365 Appsで動作します。 App Assure エンジニアは、追加コストなしで発生する可能性のある問題の解決に役立ちます。

アプリの互換性の問題が発生した場合は、App Assure エンジニアが協力して問題の解決に役立ちます。 当社の専門家は以下を行います。

  • 根本原因のトラブルシューティングと特定に役立ちます。
  • アプリケーション互換性の問題の修復に役立つガイダンスを提供します。
  • Engage独立系ソフトウェア ベンダー (ISV) に代わってアプリの一部を修復し、最新バージョンの製品で機能するようにします。
  • Microsoft 製品エンジニアリング チームと協力して、製品のバグを修正します。

App Assure の詳細については、「App Assure を使用してアプリを Microsoft Edge に持ち込む: ヒントとコツ」を参照してください。 App Assure とのアプリの互換性を要求するには、Microsoft FastTrack登録フォームに入力するか、メールをachelp@microsoft.comに送信します。

アドインを更新する

アドインを更新する場合は、Web アプリケーションとアドイン パッケージ (マニフェストを含む) の 2 つの点を考慮する必要があります。

Web アプリケーションを更新する

Web アプリケーションへのUpdatesは、ユーザーからの操作を必要としません。 新しい HTML、CSS、コード、その他のファイルを Web アプリケーションと CDN にアップロードすると、ユーザーは自動的に新機能の表示を開始します。 一部のアドイン成果物 (ボタン アイコンなど) は、アドインが最初にインストールされるときにキャッシュされます。 更新されたアイコンが最初に表示されない場合があります。 ユーザーが古いアイコンを見て混乱している場合は、Office アプリケーションを閉じて再度開くと、成果物の最新バージョンがダウンロードされます。 それでも問題が発生しない場合は、すべての Office アプリケーションを閉じてから Office キャッシュをクリアする方法を指示できます。 これにより、インストールされているすべてのアドインからキャッシュされた成果物が削除されますが、次回 Office アプリケーションが起動すると再びダウンロードされるため、この唯一の効果はアイコンが表示されるのに非常にわずかな遅延です。

アプリ パッケージ ファイルを更新する

マニフェストまたはアプリ パッケージ内の他のファイルを変更するには、ユーザーが更新する必要があります。 Microsoft Marketplace にアドインを発行した場合は、申請を更新する必要があります。 そのプロセスの詳細については、「既存のオファーを 更新する」の記事を参照してください。

マニフェストまたはアプリ パッケージ内の任意のファイルに変更を加えるたびに、マニフェストのバージョン番号を上げる必要があります。 (これには、Copilot 構成ファイルなど、アプリ パッケージ内の補助構成ファイルを指すマニフェスト内の URL への変更が含まれます)。

  • アドインで統合マニフェストを使用する場合は、「 version プロパティ」を参照してください。
  • アドインがアドインのみのマニフェスト (アプリ パッケージがない場合) を使用する場合は、「 Version 要素」を参照してください。

アドインが 1 人以上の管理者によって組織に展開されている場合、マニフェストの変更によっては、管理者が更新プログラムに同意する必要があります。 ユーザーは、同意が付与されるまでアドインからブロックされます。 次のマニフェストの変更では、管理者がもう一度同意する必要があります。

アドインを安全に保つ

Office アドイン用 Yeoman Generator または Microsoft 365 Agents Toolkit を使用して作成されたアドイン プロジェクトは、Microsoft などの多数のライブラリに依存しています。 これらのライブラリは、Microsoft 365 アクティビティとは別に更新されます。 アドインの開発、発行、保守を行う際には、プロジェクトを最新の状態に保つ必要があります。 次のツールは、プロジェクトが依存ライブラリのセキュリティで保護されたバージョンを使用していることを確認するのに役立ちます。

このガイダンスは、 Office アドインのコード サンプルやその他のソースから取得したサンプルのコピーにも適用されます。

トラブルシューティング

  • 更新されたアドインにユーザーがアクセスできません。 マニフェストのバージョンがインクリメントされ、Marketplace の申請が更新されたことを確認します。
  • 同意ダイアログ管理表示されません。 アクセス許可/スコープ/イベントが実際に変更されていることを確認します。 開発テナントでテストします。

コミュニティエンゲージメント

Microsoft 365 Developer Platform の更新プログラムが提案されると、フィードバックを受け取ります。 懸念事項、潜在的な結果、またはその他の質問を 、Office アドインの追加リソースに記載されているチャネルに報告してください。

毎月の Office アドイン コミュニティ コールを通じて、新機能や進化するベスト プラクティスに関する最新情報を入手できます。

関連項目

  • Last updated on