Quiver ダッシュボードを Marketplace 製品に追加する

Foundry DevOps を使用して Quiver ダッシュボードを Marketplace 製品に含めると、ほかのユーザーがインストールして再利用できます。Marketplace 製品を作成する方法はこちら。

サポート対象の機能

次の機能を持つ Quiver ダッシュボードがサポートされています。

• オブジェクトセットの絞り込み、セット演算、リンクされたオブジェクトセットなどのオブジェクト分析カード。
• 棒グラフ、折れ線グラフ、ヒートグリッドなどのオブジェクトベースの可視化（チャート）。Vega プロットも、基盤となる変換テーブルがサポートされている場合はパッケージ化できます。
• イベントやグループ化されたプロットを含む時系列チャートとプロット。
• ほとんどのピボットテーブル、およびグループ化、結合、フィルターなどの変換を含む変換テーブル。
• 数値カード、文字列カード、テキストカード、日付/時刻カードなどの基本的な可視化がサポートされています。

ダッシュボードをパッケージ化する方法

1. ダッシュボード設定ペインの右側で、Marketplace のテンプレートを有効化オプションを選択します。
2. ヘッダーの検証を実行ボタンを選択して、Marketplace のテンプレート化に関する潜在的な問題がないか確認します。
3. 検証ツールにエラーが表示されなければ、ダッシュボードの公開または再公開ボタンで、Marketplace に対応したダッシュボードのバージョンも保存されます。
4. そのダッシュボードのバージョンを、新しい、または既存の Marketplace 製品で使用します。

Linter のエラー

Linter は、主に次の3種類のエラーを示す場合があります。

• 未対応のカード：現在、そのカードは Marketplace のテンプレート化に対応していません。
• 未対応の設定：カード自体は対応していますが、その設定には対応していません（以下のピボットテーブルの例など）。詳細については、表示されたエラーメッセージを確認してください。
• 予期しないエラー：ほとんどの場合、上記の2項目を解決すると、予期しないエラーも解消されます。予期しないエラーが残る場合は、Palantir サポートにお問い合わせください。

ダッシュボードごとに Linter で解析する代わりに、分析全体で Marketplace の Linter 解析を有効にして、作業中に自動で検証を実行できます。分析全体の Linter 解析を有効にすると、保存ボタンの横に Marketplace の検証インジケーターが表示され、現在の検証ステータスと検出されたエラーおよび警告の数を確認できます。検証の詳細を確認するには、インジケーターを選択します。

グローバル設定パネルで、Marketplace の Linter 解析を有効化オプションを選択すると、分析内のすべてのダッシュボードで Marketplace のテンプレート化が有効になり、分析全体の Linter が有効になります。個々のダッシュボードでは、引き続きダッシュボード設定からテンプレート化を無効にできます。

Marketplace のインストールに必要な入力

検証に成功すると、ヘッダーに入力を表示オプションが表示されます。これを選択すると、Marketplace でパッケージ化する際にダッシュボードが必要とするオブジェクトタイプ、オブジェクトのインスタンス、関数、リンクタイプの一覧が表示されます。オブジェクトタイプの入力については、各入力の右側にあるプロパティのテキストにカーソルを合わせると、マッピングが必要なプロパティタイプの一覧を確認できます。

分析履歴ダイアログのダッシュボードセクションには、パッケージ化の検証が完了したダッシュボードのバージョンが表示されます。

インストールしたダッシュボードから分析を作成する

基盤となる Quiver 分析はダッシュボードと一緒にパッケージ化されませんが、ダッシュボードから分析を作成を選択すると、インストールしたダッシュボードから新しい Quiver 分析を作成できます。

作成された分析には、このダッシュボードのコピー、ダッシュボードに表示されるすべてのカード、およびそれらの上流の依存関係が含まれます。

機能の使用上の考慮事項

この機能は、現在も活発に開発が進められています。以下の重要な使用上の考慮事項に留意してください。

未対応のカードと設定

基盤となるデータから設定が決まる一部のカードは、Marketplace 向けのパッケージ化に制限があります。詳細については、以下のピボットテーブルとデータセットのセクションを参照してください。

時系列

Foundry の時系列機能のほとんどは、Marketplace 製品でサポートされています。ただし、時系列メジャーは、現在 Marketplace では利用できません。

Marketplace との互換性を確保するため、ダッシュボードは次の条件を満たす必要があります。

• 時系列の機能と変換で、メジャーの機能を使用しないこと。
• 変換テーブルや Object Set View にメジャー列が追加されていないこと。これらの列は、変換テーブルの表示設定から削除できます。

メジャーが使用されていることを Linter が検出すると、未対応の設定エラーが発生し、問題のあるカードやメジャーの詳細が示されます。

メジャーの機能を使用する代わりに、センサーオブジェクトから系列を直接インポートできます。この方法はサポートされています。

ピボットテーブル

ピボットテーブルカードは利用可能ですが、下流に変換テーブルがある場合は制限があり、列名の変更や行の操作に影響します。カードが次の条件を満たしていることを確認してください。

• 列プロパティを含まないこと。列が基盤となるデータに基づいて作成されるためです。
• 安定した一意の列名を確保するため、入力のピボットテーブルカードで、すべての集計にラベルが設定されていること。

また、ピボットテーブルの下流に選択されたオブジェクトセットカードがある場合、パッケージ化前にその選択データがクリアされます。

データセット

データセットのデータ型を使用するカードはパッケージ化できますが、制限があります。パッケージ化およびインストールの際に列名は変更されないため、インストール先のオブジェクトタイプに合わせて更新されることはありません。パッケージ化時とは異なるオブジェクトタイプでダッシュボードをインストールした場合、ダッシュボード内のデータセットカード（およびその下流のカード）の読み込みに失敗することがあります。具体的には、列名を API名に変更が有効かどうかに応じて、プロパティタイプのAPI名または元データセットの列名が、元のオブジェクトタイプのものと一致している必要があります。