Report Builder のトラブルシューティングとベストプラクティス

Report Builder の配信を最適化する方法や、時々発生する可能性のあるエラーメッセージのリストを示します。

Report Builder 5.0 のユーザーと 5.1 ワークブックの表示

ディメンションと分類の区切り文字がアンダースコア文字(_)から || に変更されました。この変更は、Report Builder 5.0 のユーザーが分類のリクエストで Report Builder v5.1 ワークブックを開く際の互換性に影響します。v5.1 より前のバージョンのワークブックを開くたびに、シリアル化された分類のリクエストがすべて、このフォーマットに変換されます。

これによって、次のような互換性の問題が発生します。ワークブックが Report Builder v5.0 のユーザーと共有されている場合、一旦 v5.1 に変換されると、v5.0 のユーザーは分類のリクエストを認識できなくなります(v5.0 では "_" が検索されるのに、v5.1 では "||" をシリアル化しています)。

ARB v5.1 ワークブックを分類のリクエストで開くときには、次のような不具合が発生します。

  • ワークブックを開くと、次の警告が表示されます。「このワークブックは、Report Builder バージョン 5.1 を使って最後に保存されています。このバージョンには、このコンピューターにインストールされているバージョンの Report Builder と互換性のない機能が含まれています。このワークブックを更新する前に、Report Builder の最新バージョンにアップグレードすることを強くお勧めします。」
  • 分類で ARB リクエストを右クリックしても、Report Builder のコンテキストメニュー(リクエストの編集、依存リクエストの追加など)が表示されません。
  • 3 番目のボタンをクリックするか、リクエストマネージャーフォームからリクエストのセットを更新することによって、「すべて更新」を実行すると、分類のリクエストがエラーなく実行されます。ただし、分類値は書き込まれません。
  • リクエストマネージャーを開き、適切なリクエストに到達するまで 1 行ずつ移動することによって、リクエストを編集することはできます。
  • リクエストを編集し、すべてのパラメーターを同一のままにして、「完了」をクリックすると、応答は適切に書き込まれます。実際、リクエストを編集することによって、応答レイアウトパラメーターが再シリアル化されるので、問題が解決します。つまり、時間はかかりますが、回避策はあります。

Report Builder の認証の問題

Report Builder では、レポートスイートからデータリクエストを作成する場合、認証が必要になります。Analytics の設定やネットワークの状況によっては、Report Builder へのログインで問題が発生することがあります。

  • 無効なログイン会社名:このエラーは、通常、ログイン会社が正しく入力されていないか、ネットワークアクティビティに問題がある場合に発生します。 以下の対策を実行してください。
    • ログイン会社名のスペルに、タイプミスや不要なスペースがないことを確認する。
    • 同じログイン会社名を使用して Analytics にログインし、ログイン会社名が正しいことを確認する。これらの認証情報を使用してログインできない場合は、組織の管理者に正しいログイン会社名について問い合わせてください。
  • ファイアウォール:Report Builderでは、ポート80と443を使用します。 これらのポートが組織のファイアウォールで許可されていることを確認してください。また、その他のファイアウォール例外条件については、アドビの内部 IP アドレスの情報も参照してください。

リクエストの最適化に関する推奨事項

次の要因によって、リクエストが複雑になり、処理が遅くなる可能性があります。

  • 配信の速度が低下する可能性がある要因:数時間の間に、過多のブックマーク、ダッシュボード、Report Builderワークブックがスケジュールされた。 また、ほぼ同じ時間にスケジュールされたReport Builderワークブックが多すぎる場合も考えます。 この場合、レポート API キューはバックログされます。

  • ワークブックの実行時間を長くさせる要因:分類が大幅に増加した場合や、リクエストの日付範囲が経時的に増加した場合。

  • ワークブックの配信に失敗する原因:ワークブック内の複雑なExcel式(特に日付と時間を含む式)。

  • 0を返す(値を返さない)セル:Excelのシート名にアポストロフィまたは一重引用符があると、report builderから値が返されません。 (これは Microsoft Excel の制限です。)

  • 個別のリクエストのパフォーマンス:処理速度は、次の設定の影響を受ける場合があります。

    設定 パフォーマンス向上 パフォーマンス低下
    分類および分類の順序 少ない 多い
    例:A を Z で分類する場合、A の項目数は常に Z の項目数より少なくする必要があります。逆の場合はリクエスト時間が大幅に増加します。
    日付範囲 短い 長い
    フィルター 具体的なフィルター 最頻使用フィルター
    精度 集計 1 時間ごと
    • 毎日
    • 毎週
    • 毎月
    • 毎四半期
    • 毎年
    エントリ数 小規模なデータセット 大規模なデータセット
  • スケジュール時間:24時間にわたってスケジュールを分散させます(以下の表を参照)。 既存のブックマーク、ダッシュボードおよび Report Builder ワークブックを共に近い時間にスケジュール設定すると、遅延が発生する場合があります。大規模で複雑なリクエストを早朝にスケジュールし、営業日中に手動での取り込みや更新ができるようにします。

    スケジュール時間 午前 1 時 ~ 午前 2 時 午前 2 時 ~ 午前 7 時 午前 7 時 ~ 午後 6 時 午後 6 時 ~ 深夜
    Report Builder の使用状況 少ない 非常に多い クライアント側の使用。
    多くのユーザーが、ローカルからの更新や「すぐに送信」のリクエストを行います。
    追加事項として、スケジュールされたワークブックがタイムアウトしたときに API キューがクリアされるかを検証します。
    多くない
  • タイムアウト:すべての予定レポートは、4時間後にタイムアウトになります。 システムでその後 3 回スケジュールが試行されると、エラーが発生する可能性があります(通常、データセットが大きいほど実行時間が長くなります)。予定レポートは Analytics レポートおよび Report Builder の次の場所で表示できます。

エラーメッセージの説明

Report Builder の使用中に表示されることのあるエラーメッセージのリストです。

メモ

ここに紹介するエラーメッセージは一部のみであり、すべてを網羅したものではありません。エラーの解決法について詳しくは、管理者にお問い合わせください。

  • この機能は開いているワークブックでのみ適用できます。:Excelでワークブック(スプレッドシートドキュメント)が開かれていない状態で、report builderツールバーのアイコンの1つをクリックすると、このメッセージが表示されます。 また、スプレッドシートを開くまではツールバーは無効になります。ただし、オンラインヘルプアイコンはクリックできます。その場合はこのエラーが発生せずに、ツールバーは有効な状態のままになります。
  • リクエストウィザードを終了してからリクエストマネージャーを起動する必要があります。:リク エストマネージャー とリクエストウィザードは機能的にリンクされていますが、リク エストウィザードでの操作を完了またはキャンセルする前に、リクエス トマネージャーでの作業に開始することはできません 。
  • この範囲に関連付けられているリクエストはありません。:スプレッドシートのセルにリクエストが含まれていない場合に、リク エストマネージャの「シート から」ボタンをクリックすると、このエラーメッセージが表示されます。 スプレッドシート内でリクエストが含まれるセルを特定するには、リクエストマネージャー内のテーブルに表示される個々のリクエストをクリックします。リクエストがセルと関連付けられている場合、そのセルが強調表示されます。
  • 選択されている範囲が無効です。別の範囲を選択してください。:スプレッドシートのセルが選択され、既にマッピングされたリクエストがある場合、このエラーが発生します。 セルにマッピングされているリクエストを削除するか、別のセルの範囲を選択してマッピングしてください。セルを削除したい場合は、リクエストを含むセルを選択して、リクエストを削除してからセルを削除する(行または列を削除する)ことが重要です。
  • この機能を使用する前に Excel のセルの編集を終了してください。:Excelのセルが 編集モードの場合 、Report Builderアイコンの1つをクリックすると、このエラーメッセージが表示されます。 Excel のセルの編集モードとは、セルが選択され、カーソルがセル内部に表示されている状態です。また、Excel の上部の数式バーや名前ボックスに直接入力しているときにも、Excel のセルの編集モードの状態になっています。
  • 選択した範囲は別のリクエストの範囲と交差します。選択を変更してください。:セルのセットをスプレッドシートに既にマップしている場合は、このエラーが表示されます。
  • ワークブックの修復(削除されたレコード:/xl/calcChain.xmlパートの数式):保存時や転送時に、ブックの数式が破損する場合があります。 ファイルを開くと、Excelはこれらの数式を実行しようと試み、失敗します。 この問題は、スプレッドシートから削除し、Excelで数式の計算 calcChain.xml を更新する必要があるので、解決できます。
    1. ワークブックのファイル拡張子をからに変更 .xlsx.zipます。
    2. 内容を解凍し、フォル /xl/ ダーを開きます。
    3. 削除 calcChain.xml.
    4. 内容を再圧縮し、ファイル拡張子をに戻し .xlsxます。
    5. Excelでワークブックを開き、すべてのReport Builderリクエストを更新します。
  • 入力フィルターーまたは出力範囲に関連付けられているExcelセルが削除された可能性があります:Report Builderでは、Excel名を使用して、セルにデータリクエストを添付します。 [名前管理]からExcel名を削除すると、このエラーが表示されます。 Excel名を削除すると、リクエストを復元できません。 ワークブックがスケジュールされている場合は、スケジュールマネージャからコピーをダウンロードするか、以前に配信されたワークブックのコピーを開くことができます。

このページ