Excelワークブックのトラブルシューティング

19 Excelワークブックのトラブルシューティング

Oracle Visual Builder Add-in for Excelで問題が発生した場合は、次のステップに従って問題を特定し、解決してください。それでも問題を解決できない場合は、Oracle Supportに問い合わせてください。

ドキュメントを確認して、必要な操作がサポートされていることを確認します。
「クライアント・ヘルス・チェック・ツール」をダウンロードして実行します。
「サポートされるプラットフォーム」が表示されていることを確認します。
アドインの「最新バージョン」にアップグレードします。
使用可能な「Microsoftの更新」を適用します。
すべてのワークブックを閉じてExcelを終了し、単純なステップで再試行してください。
レビュー用のアドイン・ログを生成します。「ロギング」を参照してください Oracle Supportに連絡すると、このログを指定するように求められる場合があります。
必要に応じて診断レポートを生成します。「診断レポート」を参照してください。
ログイン・ページに問題がある場合は、ブラウザ・キャッシュをクリアしてみてください。「埋込みブラウザ・キャッシュのクリア」を参照してください。
ワークブックを開いた後に一部のOracle Visual Builderリボン・コマンドが無効になっている場合は、ワークブック情報ウィンドウで問題の詳細を確認してください。「ワークブック問題の解決」を参照してください。

ノート:

通常の操作中に不正なリクエスト・エラーなどのネットワーク問題が発生した場合は、RESTサービスに問題がある可能性があります。 RESTサービスの所有者に連絡して、サービスが予期されるレスポンスを提供しているかどうかを判断します。ネットワーク・モニターを使用して、RESTサービス所有者と共有するリクエスト/レスポンス・ペアの詳細を取得できます。ステップについては、「ネットワーク・モニター」を参照してください。

環境をチェック

クライアント・ヘルス・チェック・ツールを実行して、デスクトップ構成および環境がOracle Visual Builder Add-in for Excelに適しているかどうかを確認し、問題を解決します。

Oracle 「ダウンロード」ページから最新バージョンのクライアント・ヘルス・チェック・ツール(vbafe-health-check.exe)をダウンロードします。

vbafe-health-check.exeを実行し、各検査アイテムの結果を確認します。

「図client-health-check-tool.pngの説明」

問題の解決に必要なステップなど、各失敗アイテム()の詳細を選択します。アドインが問題を解決できる場合は、「問題の修正」ボタンが有効になります。

ノート:
クライアント・ヘルス・チェック・ツールで、最適でないものが見つかった場合、警告()も表示されることがあります。アドインを使用するために警告を解決する必要はありませんが、解決することをお薦めします。警告のある各アイテムを選択して、警告の解決方法に関する情報を表示します。
「問題の修正」(使用可能な場合)をクリックするか、指示に従って問題を解決します。
Oracle Supportがレポートのコピーをリクエストした場合:
1. 「レポートに名前を付けて保存...」をクリックして、レポートの名前とロケーションを選択します。
2. レポートをレビューし、機密情報をすべて削除します。
3. レポートをOracle Supportに送信します。

Microsoft更新の適用

Oracle Visual Builder Add-in for Excelの問題をトラブルシューティングする場合、問題を再現する前に、WindowsおよびExcelのすべての保留中の更新を適用することをお薦めします。 Microsoftパッチによって問題が解決される場合があります。

Windowsのスタート・メニューから、「設定」、「更新&セキュリティ」、Windows Updateの順に選択します。
「Windows Update」ページで更新が使用可能な場合は、更新を確認して「今すぐインストール」をクリックします。

ノート:
Windowsの更新の適用の詳細は、バージョンごと、および企業のITポリシーによって異なる場合があります。必要に応じて、システム管理者に確認してください。

ネットワーク・モニター

予期しない動作が発生した場合に、ExcelワークブックとRESTサービス間のRESTサービス・コールの内容を検査するには、ネットワーク・モニター・ウィンドウを使用します。

ネットワーク監視ウィンドウには、ワークブックから発信された各RESTコールの開始時間、経過時間、レスポンスなどの情報が表示されます。また、Oracle Visual Builder Add-in for Excelから送信された各リクエストのヘッダーとペイロード、およびサービスからの対応するレスポンスも提供します。このウィンドウには、100件までのリクエスト/レスポンス・イベントが表示されます。古いイベントは新しいイベントが追加されると破棄されます。

不正リクエストなどのRESTサービスで問題が発生した場合、「ネットワーク・モニター」ウィンドウでエラーに関する情報を取得し、この情報をRESTサービスの所有者と共有できます。

ネットワーク・モニター・ウィンドウは、一般にユースケースのステップを実行する際にバックグラウンドに入ります。各リクエストとレスポンスの詳細を確認するには、ウィンドウを前面に移動します。

Excelで、Oracle Visual Builderタブをクリックします。
「ネットワーク・モニター」を選択してネットワーク・モニター・ウィンドウを開きます。
問題の原因となったステップを繰り返します。
リクエストおよびレスポンスの詳細を下のペインに表示するには、上の表から各リクエストおよびレスポンス行を選択します。
リクエストおよびレスポンスの詳細を保存するには、上の表でRESTサービス・コールのエントリを選択し、「保存」をクリックします。

注意:
リクエストおよびレスポンスのペイロードには、実際のデータや個人を識別できる情報などの機密情報が含まれる場合があります。これらのペイロードは、必ず注意して処理してください。

インストール・ログ

Oracle Visual Builder Add-in for Excelインストーラは、標準のMicrosoft Windowsインストーラ・ログを生成するWindowsインストーラです。 Oracle Visual Builder Add-in for Excelのインストールに問題がある場合は、インストール・ログ・ファイルを生成して表示できます。

インストール・ログ・ファイルを生成するには、コマンドラインからインストーラを実行し、/log <log file path>を含めます。「コマンド行からのインストーラの実行」を参照してください。

アドイン・ログ・ファイルには、コンピュータ名とエンド・ユーザーのWindowsプロファイル名など、ユーザー・コンピュータからの個人情報が含まれる場合があります。個人情報を含むファイルをサービス・リクエストにアップロードするときは、必要に応じてファイル・アクセスを制限できるように、適切なオプションを選択してください。

ロギング

アドインに関する問題を報告する場合は、報告する問題につながるステップを取得する詳細なログ・ファイルを生成します。

生成するログ・ファイルにより、Excelセッション中のステップに関する情報が取り込まれます。

Excelで、Oracle Visual Builderタブをクリックします。
詳細メニューから「ログを記録」を選択して、ログ・ファイルのディレクトリのロケーションとファイル名を指定します。これにより、ロギング・セッションが開始されます。
問題につながるステップを繰り返します。
ログ・ファイルにアクセスする前に、Excelを完全に終了してロギング・セッションを停止します。

ノート:
次回Excelロギングを実行すると、有効ではなくなります。

注意:

ログ・ファイルには、コンピュータ名やエンド・ユーザーのWindowsプロファイル名など、ユーザー・コンピュータからの個人情報が含まれますが、これらに限定されません。必要に応じてファイル・アクセスを制限できるように、個人情報を含むファイルをサービス・リクエストにアップロードする場合は、適切なオプションを選択してください。

ログ・コンソール

ログ・コンソールには、実行されたアクションに基づいてログ・メッセージが表示されます。問題が発生した場合は、ロギング・メッセージを表示して、問題のトラブルシューティングおよび診断を行います。

ノート:

サポートするログ・ファイルを指定する場合は、ログ・コンソールからログ・エントリをコピーするのではなく、「ロギング」を参照してログ・ファイルを生成してください。

ログ・コンソールでログ・メッセージを確認するには:

Excelで、Oracle Visual Builderタブをクリックします。
「ログ・コンソール」を選択します。
ロギング・コンソール・ウィンドウが表示されます。
問題の原因となったステップを繰り返します。
ログに記録されたメッセージを確認します。
必要に応じて、次のいずれかの操作を行います:
- 「フィルタ」ボックスに単語またはフレーズを入力すると、一致するログ・エントリが表示されます。
- 時間、スレッド、レベルなどの詳細を表示するには、「イベント詳細の表示」をクリックします。
- 詳細ロギングの場合は、「詳細出力の有効化」をクリックし、問題の原因となったステップを繰り返します。
- 「クリア」をクリックして、すべてのログ・エントリを破棄します。

診断レポート

診断レポートには、問題を解決するために役立つ情報が含まれています。 Oracle Visual Builder Add-in for Excelで問題を報告する際に診断レポートを提供します。

Excelで、Oracle Visual Builderタブをクリックします。
詳細メニューから「診断レポート」を選択します。
選択したファイル名で診断レポートをディレクトリのロケーションに保存します。

ノート:

レポートには、コンピュータ名とエンド・ユーザーのWindowsプロファイル名など、ユーザー・コンピュータからの個人情報が含まれる場合があります。必要に応じてファイル・アクセスを制限できるように、個人情報を含むファイルをサービス・リクエストにアップロードする場合は、適切なオプションを選択してください。

Re-Enable Oracle Visual Builder Add-in for Excel

アドインが無効になり、「クライアント・ヘルス・チェック・ツール」を使用できない場合は、Microsoft ExcelからOracle Visual Builder Add-in for Excelを再度有効にできます。

Excelで、「ファイル」>「オプション」>Add-Insをクリックします。
管理ドロップダウン・リストで「COMアドイン」を選択し、「実行」をクリックします。
Oracle Visual Builder Add-in for Excelチェック・ボックスの選択を解除し、OKをクリックします。
Excelを再起動します。
ステップを繰り返し、かわりに「COMアドイン」ダイアログの「使用可能なアドイン」リストからOracle Visual Builder Add-in for Excelチェック・ボックスを選択して、アドインを有効にします。
「図disableaddin.pngの説明」

ワークブック問題の解決

ワークブックを開いたとき、または一部のOracle Visual Builderリボン・コマンドが無効になっていることに気付くと、Oracle Visual Builder Add-in for Excelによってワークブックの問題が検出されました。ワークブック情報ウィンドウを使用して、これらの問題のトラブルシューティングを行います。

ワークブックは、Excelで最終としてマークされている、または互換性のないファイル・タイプに保存されているなど、様々な理由で使用できない場合があります。

ワークブックのステータスを確認するには、Oracle Visual Builderリボンの「上級」メニューから「ワークブック情報」を選択して、ワークブック情報ビューアを開きます。このビューアには、ワークブックの名前、ロケーション、ステータスなどの情報が表示されます。

「図workbook-info-screen.pngの説明」

問題の説明およびトラブルシューティング・ステップのステータスを確認します。問題のないワークブックのステータスは"Integrated"です。アドインと統合されていないワークブックには、"Not integrated"のステータスが表示されます。

ワークブックが"final"としてマークされているシナリオでは、(「ファイル>情報>ワークブックの保護」の下にある) 「最終としてマーク」設定をクリアし、ワークブックを保存して再オープンする必要があります。

ノート:

黄色のメッセージ・バーのExcel 「そのまま編集」ボタンを使用して、ワークブックを編集しないでください。このコマンドは、Oracle Visual Builderリボンを再度有効にしません。