トラブルシューティング - アプリ内レポート

配布リスト ファイルをアップロードする際に、アプリのリロードが失敗する

考えられる原因  

これは、配布リストを追加する前のロード スクリプトの末尾のフォーマット方法に関する多数の問題が原因だと考えられます。

一般的な例:

• 現行のロード スクリプトの末尾に、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

列タグを削除して、テーブル チャートのデータをテーブル タグとしてテーブルに戻します。それにより、条件が満たされていなくてもこのテンプレートを使ったレポート タスクは正常に実行されます。

レポート タスクの実行に失敗しました - 一意のレポートの最大数に達しました

次のメッセージが表示され、レポート タスクの実行に失敗しました。

このタスクの一意レポートの最大数に達したため、レポートは送信されませんでした。詳細については、受信者リストを確認してください。

考えられる原因  

レポート タスクは最大 500 個の一意のレポートを生成できます。この制限はタスクのテンプレートごとではなく、タスクに追加されたすべてのテンプレート全体で評価されます。また、この制限は、1 つ以上のサイクルが適用されているかどうかに関係なく、すべてのレポート タスクに適用されます。

提案されたアクション  

レポート タスクを編集し、実行ごとに 500 個未満の一意のレポートが生成されるように定義を変更します。それでも一度に 500 個を超える固有のレポートを作成する必要がある場合は、同様の配信設定を持つ個別のタスクを作成できます。

レポートに、想定していたデータが含まれていない

考えられる原因 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 ワークブックで [フォント] と [テーマ]を調整します。これらの設定は、[ページ レイアウト] にあります。

画像寸法の変化は修正しにくいため、画像を使用しているレポートの場合、同じオペレーティング システムを使用してテンプレート全体を開発することを検討してください。

Excel テンプレートから生成されたレポートで使用されているフォントが不適切

考えられる原因  

テンプレートではカスタム フォントが使用されます。

Excel テンプレート ファイルでのカスタム フォントの使用はサポートされていません。テンプレートにレポート生成に使用できないフォントが含まれている場合、これらのフォントを使用する要素では、生成されたレポートで既定の Excel フォントが使用されます。

提案されたアクション  

Excel テンプレートを作成するときは、最初に使用したカスタム フォントにもっとも一致する Excel フォントを使用します。これは、レポート出力で予期しない結果を回避するための最善の方法です。

ファイル名 (またはファイル名プレビュー) のレポート生成のタイムスタンプが正しくない

考えられる原因  

レポート タスクの所有者が、個人用設定で優先タイム ゾーンを設定していません。優先タイムゾーンが明示的に設定されていない場合、レポート ファイル名には UTC のタイムスタンプが使用されます。

提案されたアクション  

レポート タスクを所有するユーザーは、 個人用設定でタイム ゾーンを設定する必要があります。

次の手順を実行します。

1. Qlik Cloud で、右上のユーザー プロファイル メニューをクリックします。

2. [設定] をクリックします。

3. [タイムゾーン] で希望のタイムゾーンを選択します。

アプリ内のチャートが変更された後、PixelPerfect レポートを生成できない

考えられる原因  

ソース アプリ オブジェクトの軸とメジャーが追加、削除、または再構成されました。

提案されたアクション  

詳細については、「Data binding」を参照してください。