トラブルシューティング - アプリ内レポート
このヘルプ トピックでは、Qlik Cloud Analytics のアプリ内レポートを処理する際に発生する一般的エラーの解決方法について示します。
配布リスト ファイルをアップロードする際に、アプリのリロードが失敗する
考えられる原因
これは、配布リストを追加する前のロード スクリプトの末尾のフォーマット方法に関する多数の問題が原因だと考えられます。
一般的な例:
-
現行のロード スクリプトの末尾に、Exit script ステートメントがある。
-
ロード スクリプトの最後の LOAD または SELECT ステートメントの末尾にセミコロンがない。
提案されたアクション
上記の例では、次の解決方法が考えられます。
-
新たに追加された Distribution List スクリプト セクションを Exit script ステートメントの上の新しい場所に動かします。または、ユース ケースとスクリプト コンテクストで適切と思われる場合は、Exit script ステートメントを削除します。
-
欠落しているセミコロンを追加します。
レポート タスク: 「一部のユーザーへの送信に失敗しました。」
レポート タスクが、何人かのユーザーに送信される可能性がありますが、他のユーザーには送信できませんでした。
考えられる原因 1
これらの受信者の電子メール アドレスが、配布リストで変更されました。レポート タスクに追加された各受信者に対してレポートを生成すると、Qlik Cloud が配布リストで電子メール アドレスを検索します。一致がなかった場合、そのユーザーに対してレポートは生成できません。
考えられる原因 2
配布リストで参照された 1 件以上の レポート フィルター がアプリで見つかりませんでした。例:
-
フィルターの名前がアプリで変更されたが、配布リストでは更新されていない。
-
フィルターがアプリで削除されたが、配布リストで参照され続けている。
-
配布リストで参照されたリストがアプリに追加されていない。
提案されたアクション 1
ベスト プラクティスは、グループを使用してユーザーをレポート タスクに追加することです。グループとは受信者の集合です。グループの一部としてタスクに追加された受信者の電子メール アドレスを変更すると、レポートが生成され、更新された電子メール アドレスに送信されます。
レポート タスクに単一受信者を追加する必要がある場合、レポート タスクから元のユーザーを削除して、更新された電子メール アドレスで追加しなおします。
詳細は、レポートの配布リストの作成をご覧ください。
提案されたアクション 2
フィルター名を更新して、アプリと配布リスト間で一致させます。必要に応じてフィルターを追加します。フィルターが削除されて適用不可となった場合、配布リストからその参照を削除します。
レポート タスク:「送信失敗: 生成できませんでした」
考えられる原因 1
テンプレートが、表レポートに対応されていない Excel 機能を使用している。
例:
-
アプリケーション、マクロ、およびスクリプト向けの Visual Basic
-
サードパーティの拡張
考えられる原因 2
アプリで 1 つ以上の項目が常に 1 つの選択された値で設定されており、これら各項目に対して 1 つの値を選択するレポート フィルターがレポート タスクに適用されていない。
考えられる原因 3
次のような動作が発生しました。
-
1 つ以上の列タグを使って、テーブル チャートの値をアプリからテンプレートに追加した。
-
アプリで、1 つ以上の [テーブル] 列に [次の場合列を表示] 設定が適用されている。
-
レポート生成時に、これらの列の [次の場合列を表示] の条件が満たされていない。
テーブル チャートで設定された 次の場合列を表示 条件に関連付けられた列タグを追加する際、そのテンプレートを使用しているレポート タスクを実行するときに条件が満たされている必要があります。そうでない場合、レポート タスクは失敗します。
提案されたアクション 1
対応していない Excel 機能を使用しないテンプレートを作成します。
Microsoft Excel の Qlik アドインに対する制限事項のリストについては、「Qlik レポート サービス の仕様と制限事項」を参照してください。
提案されたアクション 2
アプリに [常に 1 つの値を選択] プロパティが構成された 1 つ以上の項目が含まれている場合、フィルターがこれらの項目ごとに 1 つの値を正確に選択するようにレポート フィルターを構成する必要があります。これらのレポート フィルターはレポート タスクに適用する必要があります。
フィルターにこれらの項目の値が含まれていないか、タスクにフィルターがまったく関連付けられていない場合、レポート タスクは失敗します。
提案されたアクション 3
列タグを削除して、テーブル チャートのデータをテーブル タグとしてテーブルに戻します。それにより、条件が満たされていなくてもこのテンプレートを使ったレポート タスクは正常に実行されます。
レポートに、想定していたデータが含まれていない
考えられる原因 1
ロード スクリプトに Star ステートメントが含まれており、レポートがフィルターを使用するよう設定されている。
考えられる原因 2
レポートが、オブジェクト フィルターを使用する Qlik NPrinting テンプレートから移行された。
提案されたアクション 1
Star ステートメントを使用しないで正常に機能するよう、ロード スクリプトを再構築します。
提案されたアクション 2
オブジェクト フィルターが、Qlik Cloud 表レポートでの使用に対応していません。オブジェクト フィルターを使用しなくても希望する結果を達成するようテンプレートを再構築します。
詳細については、「Qlik NPrinting から Qlik Cloud への Excel レポート テンプレートのエクスポート」を参照してください。
レポート タスクが無効化された
考えられる原因 1
セクション アクセス テーブルがアプリに追加された、あるいは削除された。
考えられる原因 2
アプリにセクション アクセスがあり、テナント管理者がレポート タスクの所有者を変更しました。これにより、レポート タスクが自動的に無効化されます。この場合、レポート タスクの新規所有者のみがタスクを再有効化できます。
提案されたアクション 1
セクション アクセス テーブルで定義されたデータ セキュリティ制限がレポート タスク ユース ケースに対して許容できるかどうかを評価します。許容される場合、レポート タスクを再有効化します。
提案されたアクション 2
レポート タスク所有者の変更は、タスクの個別の受信者に適用されたデータ削減に影響します。レポート タスクが Qlik Cloud テナントのユーザーでない個人にレポートを送信するよう設定されている場合、受信するデータは、新規レポート タスク所有者が受信するのと同じデータになります。
新規レポート タスク所有者が設定を評価して必要な変更を行った時点で、レポート タスクを再有効化できます。
詳細については、「アプリ内レポートとセクション アクセス」を参照してください。
Excel テンプレートを Qlik Sense アプリにアップロードするときに発生するエラー
すでに別の Qlik Sense アプリに接続されているテンプレートをアップロードしようとすると、このエラーが表示される場合があります。
テンプレート ファイルのアップロードに失敗しました。テンプレートが、Qlik Sense アプリで利用できないオブジェクトを参照しています。
このエラーは、既存のアプリの複製または公開されたコピーなど、新しいテンプレートをアップロードする際に接続された Qlik Sense アプリを更新しようとしたときに発生する可能性があります。
考えられる原因 1
テンプレートに、プライベート シートにあるオブジェクトを使用するコンテンツがあります。アプリをエクスポート、複製、公開する場合、プライベート シートは含まれません。テンプレートの接続されたアプリを変更するには、テンプレートで参照されているすべてのアプリ オブジェクトが新しいアプリに存在する必要があります。
考えられる原因 2
テンプレートで参照されている個々のオブジェクトの 1 つ以上に問題があります。
提案されたアクション 1
次のいずれかを実行します。
-
元のソース アプリに戻り、参照されているプライベート シートを公開します。
-
Microsoft Excel 用の Qlik アドインを使用してテンプレートを開き、プライベート シートに基づいて参照されているコンテンツを削除します。
提案されたアクション 2
Microsoft Excel 用の Qlik アドインを使用してテンプレートを開きます。そこで、各オブジェクトの詳細なエラーメッセージを確認して、問題を詳しく診断できます。たとえば、Qlik NPrinting からテンプレートを移行し、そのテンプレートが Qlik Cloud 表形式レポートでサポートされていないチャートの種類を参照している場合があります。
Microsoft Excel: Qlik アドインの展開後の認証中に空のダイアログが表示される
ユーザーがアドインに対して認証しようとすると、認証ポップアップ ダイアログが空白になる場合があります。あるいは、ダイアログにエラー (特に 12006) が表示されることもあります。
考えられる原因
ユーザーが Microsoft Excel 用 Qlik アドインを使用するには、認証フローでテナントと、別のドメインでホストされている ID プロバイダーの間のリダイレクトが必要です。ID プロバイダーが Cross-Origin-Opener-Policy に制限のある設定を設定しています。その結果、認証フローのクロスドメイン通信部分がブロックされ、ログイン情報がアドインに正しく返されなくなります。
提案されたアクション
次の解決策は、アイデンティティ プロバイダーの設定を担当するネットワーク管理者が実行する必要があります。
次の手順を実行します。
-
IDP からダイアログへの応答ヘッダーを次のように設定します。
Cross-Origin-Opener-Policy: unsafe-none
詳細については、Microsoft の公式ドキュメントを参照してください: Office ダイアログ API - ルールと注意事項
Microsoft Excel: 静的画像がテンプレートに表示されない
考えられる原因 1
Qlik Cloud テナントで、ユーザーに、アプリから画像をダウンロードするのに十分な権限がない。
考えられる原因 2
Microsoft Excel にマイナーな同期化の問題が発生しています。この問題は、Microsoft 365 の Excel のウェブ バージョンに限定されています。
提案されたアクション 1
割り当てのために追加の権限が必要な場合は、テナント管理者に連絡してください。
ご自身がテナント管理者である場合は、次を参照してください。
-
ユーザーと管理者のロールと権限 (ユーザーベースのサブスクリプション)
-
ユーザーと管理者のロールと権限 (容量ベースのサブスクリプション)
-
ユーザーと管理者のロールと権限 (Qlik Anonymous Access サブスクリプション)
提案されたアクション 2
Excel のリボンで [編集]/[表示] ビューを切り替えると、画像の表示が復元されます。
Microsoft Excel: macOS に保存して Windows で開きなおした後、テンプレートの外観が異なる
特に、静的画像の寸法が異なることに気づくかもしれません。ファイルのフォントも変化している可能性があります。
考えられる原因
macOS と Windows では、Excel ファイルで画像を表示する方法に技術的な差異があります。さらに、フォントもファイルで変化している可能性があります。macOS と Windows のデフォルト フォントは同一ではないため、一般的にフォントのサポートも違っています。
提案されたアクション
テンプレートの開発時にオペレーティングシステムを切り替えないようにします。これが避けられない場合 (テンプレート開発でコラボレーションを行う場合など)、必要に応じて Excel ワークブックで [フォント] と [テーマ]を調整します。これらの設定は、[ページ レイアウト] にあります。
画像寸法の変化は修正しにくいため、画像を使用しているレポートの場合、同じオペレーティング システムを使用してテンプレート全体を開発することを検討してください。
配布リスト ファイルをアップロードする際に、アプリのリロードが失敗する
考えられる原因
これは、配布リストを追加する前のロード スクリプトの末尾のフォーマット方法に関する多数の問題が原因だと考えられます。
一般的な例:
-
現行のロード スクリプトの末尾に、Exit script ステートメントがある。
-
ロード スクリプトの最後の LOAD または SELECT ステートメントの末尾にセミコロンがない。
提案されたアクション
上記の例では、次の解決方法が考えられます。
-
新たに追加された Distribution List スクリプト セクションを Exit script ステートメントの上の新しい場所に動かします。または、ユース ケースとスクリプト コンテクストで適切と思われる場合は、Exit script ステートメントを削除します。
-
欠落しているセミコロンを追加します。
ファイル名 (またはファイル名プレビュー) のレポート生成のタイムスタンプが正しくない
考えられる原因
レポート タスクの所有者が、 [プロファイル設定]で優先タイム ゾーンを設定していません。優先タイムゾーンが明示的に設定されていない場合、レポート ファイル名には UTC のタイムスタンプが使用されます。
提案されたアクション
レポート タスクを所有するユーザーは、 [プロファイル設定] でタイム ゾーンを設定する必要があります。
次の手順を実行します。
-
Qlik Cloud で、右上のユーザー プロファイル メニューをクリックします。
-
[プロファイル設定] をクリックします。
-
[タイムゾーン] で希望のタイムゾーンを選択します。