オフィスキャッシュのクリア – オフィスアドイン

Officeキャッシュは、Officeアドインが使用するリソースやデータを保存します。キャッシュを利用することで、アドインのパフォーマンスが向上します。次の場合にはキャッシュをクリアする必要があります。WindowsやMac、iOSで以前にサイドロードしたアドインを削除する場合、アドインのマニフェストを更新した場合、アドインの実行中に問題を解決したい場合です。キャッシュはWebキャッシュとWefキャッシュに分かれ、手動または自動でクリアできます。MacやiOSでも同様の方法でキャッシュ管理が可能です。

Officeキャッシュの管理方法

Officeキャッシュは、Officeアドインによって使用されるリソースやデータを保存します。保存されたリソースにアクセスすることで、アドインのパフォーマンスが向上し、必要な際に再ダウンロードを避けることができます。しかし、特定の状況ではOfficeキャッシュをクリアする必要があります。以下にそのシナリオをご紹介します。

キャッシュをクリアすべき状況

  • サイドロードしたアドインを削除したいとき: Windows、Mac、iOSで以前にサイドロードしたアドインを削除したいときにキャッシュをクリアします。
  • マニフェストを更新したとき: アイコンのファイル名やアドインコマンドのテキストを更新するためにマニフェストを更新した場合、最新のバージョンを使用するためにキャッシュをクリアする必要があります。

    ヒント: タスクペインを実装しているアドインの場合、最近の変更をHTMLやJavaScriptのソースファイルに反映させたい場合にはキャッシュをクリアする必要はありません。代わりに、アドインのタスクペインにフォーカスを合わせ(タスクペイン内の任意の場所を選択)、Ctrl+F5を押してアドインをリロードします。

  • アドインの実行時に問題やエラーを解決したいとき: アドインの動作に問題がある場合にも、キャッシュをクリアすることが推奨されます。

キャッシュの種類

Officeキャッシュは、ウェブキャッシュとWefキャッシュの二つを指します。

  • ウェブキャッシュ: 個々のOfficeアドインによって使用されるウェブベースのリソースやデータを一時的に保存します。
  • Wefキャッシュ: インストールされているすべてのOfficeアドインのリソースやデータをローカルに保存します。

以下は、異なるプラットフォームでクリアできるOfficeキャッシュのタイプを示した表です。また、特定のキャッシュをクリアするための手順へのリンクも提供しています。

WindowsでのOfficeキャッシュのクリア方法

Officeホストとオペレーティングシステムに応じて、Windowsコンピュータ上でウェブとWefキャッシュの両方を自動または手動でクリアできます。

重要: Windowsでは、自動オプションと手動オプションで両方のキャッシュがクリアされます。現在のところ、片方のキャッシュだけをクリアするオプションはありません。

自動的にキャッシュをクリアする

この方法は、アドイン開発用のコンピュータに推奨されます。WindowsのOfficeのバージョンが2108以降であれば、次の手順で次回Officeが再起動する際にキャッシュをクリアする設定ができます。

  1. Excel、PowerPoint、またはWordのリボンから、ファイル > オプション > トラストセンター > トラストセンターの設定 > 信頼されたアドインカタログに移動します。
  2. 次回Officeが起動する際に、以前に起動したウェブアドインのキャッシュをすべてクリアするチェックボックスを選択します。
  3. OKを選択します。
  4. Excel、PowerPoint、またはWordを再起動します。

手動でキャッシュをクリアする

Excel、Word、PowerPointでの手動キャッシュクリア

Excel、Word、PowerPointからすべてのサイドロードされたアドインを削除するには、次のフォルダーの内容を削除します。

%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

もし次のフォルダーが存在する場合、その内容も削除してください。

%userprofile%\AppData\Local\Packages\Microsoft.Win32WebViewHost_cw5n1h2txyewy\AC\#!123\INetCache\

Outlookでの手動キャッシュクリア

Outlookでキャッシュをクリアする前に、まずは以下の手順に従い、サイドロードしたアドインを削除してみてください。

もしこの削除がうまくいかない場合、Excel、Word、PowerPointと同様に、Wefフォルダーの内容を削除してください。

OutlookアドインがMicrosoft 365の統一マニフェストを使用している場合は、以下のフォルダーも削除します。

%userprofile%\AppData\Local\Microsoft\Outlook\HubAppFileCache

Windowsの新しいOutlookでキャッシュをクリアするための手順は次の通りです。

  1. Outlookクライアントが開いている場合は閉じます。
  2. コマンドラインから次のコマンドを実行します。
olk.exe --devtools

これにより、新しいWindowsのOutlookクライアントとMicrosoft Edge DevToolsのインスタンスが開きます。

  1. Microsoft Edge DevToolsウィンドウで、ネットワークタブを選択します。
  2. リクエストテーブル内の任意の場所を選択して、右クリック(または長押し)し、ブラウザキャッシュをクリアを選択します。

Windows 10でMicrosoft Edgeデベロッパーツールを使用する

Microsoft Edgeで実行中のアドインのOfficeキャッシュをWindows 10でクリアするには、Microsoft Edge DevToolsを使用します。

この手順を実行するには、アドインにタスクペインを実装している必要があります。UIを持たないアドインの場合、まずタスクペインを追加する必要があります。

  1. Microsoft Edge DevToolsをインストールします。
  2. Officeクライアントでアドインを開きます。
  3. Microsoft Edge DevToolsを実行します。
  4. Microsoft Edge DevTools内のローカルタブで、アドインの名前を選択します。
  5. アドインのデバッガーにアタッチするために、アドインの名前を選択します。デバッガーがアドインにアタッチされると、新しいMicrosoft Edge DevToolsウィンドウが開きます。
  6. 新しいウィンドウのネットワークタブで、キャッシュをクリアを選択します。
  7. もしこの手順でも目的を達成できない場合は、常にサーバーからリフレッシュするを選択してみてください。

MacでのOfficeキャッシュのクリア方法

Macでは、ウェブキャッシュまたはウェブとWefキャッシュの両方をクリアすることができます。

ウェブキャッシュのクリア

通常、ウェブキャッシュはアドインを再読み込みすることでクリアされます。ドキュメント内に複数のアドインが存在する場合、自動的にキャッシュをクリアするプロセスが信頼性に欠けることがあります。

Excel、PowerPoint、Wordのウェブキャッシュをクリアするには、任意のタスクペインアドインのパーソナリティメニューを使用します。

注意: パーソナリティメニューは、Excel、PowerPoint、Wordのみでサポートされています。Outlookでは、両方のキャッシュをクリアするオプションを使用する必要があります。また、パーソナリティメニューはmacOSバージョン10.13.6以降でのみ表示されます。

アドインのタスクペインから、パーソナリティメニューを選択し、ウェブキャッシュをクリアを選択します。

ウェブとWefキャッシュのクリア

MacでウェブとWefキャッシュの両方をクリアするには、次のフォルダーの内容を削除します。

~/Library/Containers/com.Microsoft.OsfWebHost/Data/
~/Library/Containers/com.microsoft.{host}/Data/Documents/wef

ここで、{host}をOfficeアプリケーション(例えばExcel)に置き換えます。

ヒント: 端末またはFinderを使用して指定されたフォルダーを検索します。Finderでこれらのフォルダーを表示するには、隠しファイルを表示する設定にする必要があります。

削除することで、アプリケーションからすべてのサイドロードされたアドインが削除されます。

iOSでのOfficeキャッシュのクリア方法

iOSでウェブキャッシュをクリアするには、アドイン内のJavaScriptから次のコードを呼び出します。

window.location.reload(true);

これにより、アドインが再読み込みされます。代わりに、Officeを再インストールすることも可能です。

まとめ

Officeキャッシュを適切に管理することで、アドインのパフォーマンスを向上させ、問題を解決できます。状況に応じてキャッシュをクリアすることを心がけ、スムーズな作業環境を維持しましょう。

————-

Clear the Office cache – Office Add-ins

Source link

The Office cache stores resources and data for Office Add-ins, enhancing performance by preventing repeated downloads of the same resources. Clearing the Office cache may be necessary in specific situations, including:

  1. Removing a Previously Sideloaded Add-in: Essential if you want to uninstall an add-in from Windows, Mac, or iOS.
  2. Updating the Add-in Manifest: Make sure you’re using the latest version when changes are made, such as updates to icons or command text.
  3. Resolving Errors: Clear the cache to troubleshoot issues encountered during the add-in’s operation.

Types of Caches

There are two main types of caches:

  • Web Cache: Temporarily stores web resources specific to an individual Office Add-in.
  • Wef Cache: Stores resources for all installed Office Add-ins.

Clearing the Cache

Windows:

  • Automatic Clearing: Supported for Excel, PowerPoint, and Word (version 2108 or later) via settings to clear caches on the next Office restart.
  • Manual Clearing: Delete contents from specified directories for sideloaded add-ins, including both web and Wef caches. Outlook requires a specific method if removal of an add-in fails.

Mac:

  • Web Cache: Can be cleared via the task pane’s personality menu.
  • Web and Wef Caches: Delete contents from specific directories in the Library.

iOS:

Clear the web cache by reloading using JavaScript (window.location.reload(true)) or by reinstalling Office.

Best Practices

  • For task pane add-ins, if you’re simply updating HTML or JavaScript, focus on the task pane and use Ctrl + F5 to reload without needing to clear the cache.
  • For persistent issues, clearing the cache (web and Wef) may be necessary to fully address the problems.

Following these guidelines will help maintain optimal performance of Office Add-ins across different platforms.

関連記事