App Pairing

App Pairing は、サポートされている Palantir プラットフォームのアプリケーションを接続し、複数のビューを同期することで、アプリケーション間のワークフローを実現します。これにより、あるアプリケーションでデータやオブジェクトを変更すると、もう一方のアプリケーションにも自動的に反映され、その逆も同様に機能します。App Pairing の機能は、作成した AIP Chatbot でコマンドを実行する際や、App Pairing ウィジェットを通じて Workshop モジュールで利用できます。また、Notepad ドキュメントでインラインコマンドを設定する際にも利用できます。

たとえば、ご自身やほかのユーザーが Graph アプリケーションでデータを変更すると、ペアリングされた Workshop モジュール内の対応するデータが更新されます。この接続を確立するには、Graph アプリケーションとペアリングする Workshop モジュールに App Pairing ウィジェットを追加します。この接続により、Graph でオブジェクトを選択すると、ペアリングされた Workshop モジュールのオブジェクトリスト内でそのオブジェクトが強調表示されます。

App Pairing ウィジェットをセットアップする

App Pairing ウィジェットを Workshop モジュールに追加する

App Pairing ウィジェットを Workshop モジュールに追加するには、Workshop に移動して + 新規モジュールを選択します。ほかの Workshop ウィジェットと同様に、Workshop のセクションまたはモジュールのヘッダーにウィジェットを追加できます。この機能はウィジェットが表示されているときに動作するため、常に表示されるように Workshop アプリケーションのヘッダーに追加することを推奨します。

Workshop アプリケーションのヘッダーにウィジェットを追加したら、名前を付けます。ほかのアプリケーションがウィジェットを識別して発見できるように、すべてのウィジェットにユーザー向けの名前を付ける必要があります。追加の設定は任意です。詳細については、以下の高度な設定セクションを参照してください。

ほかのアプリケーションと状態を共有する変数を作成する

App Pairing ウィジェットを Workshop モジュールに追加したら、右側のパネルに移動して設定を更新し、2種類の組み込み共有状態タイプである選択またはデータを開くのいずれかを使用するようにします。共有状態タイプは、App Pairing がアプリケーション間で共有する変数を定義します。

• 選択： Workshop と接続先のアプリケーションの間で、選択したデータを共有できます。アプリケーションでオブジェクトを選択すると、Workshop でも同じオブジェクトとそのメタデータが選択されます。
• データを開く： サポートされているアプリケーションに表示されているデータを Workshop と共有できます。たとえば、ユーザーが10個のオブジェクトを含むグラフを開き、Graph アプリケーションを Workshop モジュールとペアリングすると、ペアリング時にグラフ上の10個のオブジェクトすべてが Workshop モジュールに取り込まれます。

選択されたオブジェクトの変数は最もよく使われる変数タイプであるため、デフォルトでは事前に設定されています。ウィジェットが Gaia マップまたは Graph 分析とペアリングされると、デフォルト値には Gaia または Graph で現在選択されているオブジェクトが記録されます。

変数を追加を選択すると、モジュールで必要なデータ型に対応する選択またはデータを開く変数を複数追加できます。詳細は以下の高度な設定セクションを参照してください。

設定が完了すると、ペアリングされたアプリケーションからの更新によって Workshop の変数が更新されます。選択変数を使用する場合、ユーザーの Workshop モジュール内から変数を更新すると、ペアリングされたアプリケーションに更新が送信されます。

ウィジェットをペアリングする

共有状態の変数を更新するには、ウィジェットをアプリケーションとペアリングする必要があります。ウィジェットをペアリングするには、Workshop モジュールとペアリングしたいアプリケーションを開きます。開くと、そのアプリケーションは、App Pairing ウィジェットとともに Workshop に追加されたアプリのペアリングメニューに発見として表示されます。

Workshop モジュールとペアリングしたいアプリケーションの横にあるペアを選択します。選択したアプリケーションは、ペアリングメニューのペアリング済みセクションに表示されます。

サポートされているアプリケーションが見つからない場合、App Pairing ウィジェットに次のメッセージが表示されます。

Iframe ウィジェットを使用して、外部アプリケーションまたは別の Palantir アプリケーション（Gaia マップなど）を Workshop 内に埋め込んでいる場合、アプリケーションは埋め込みアプリケーションを自動的に発見してペアリングします。埋め込みアプリケーションと Workshop のペアリングを解除するには、App Pairing ウィジェットのアイコンに移動し、ペアリング済みのアプリケーションを選んで表示し、ペアリング解除を選択します。

複雑なペアリングロジックの詳細は、以下の高度な設定セクションを参照してください。

App Pairing ウィジェットの外観を設定する

App Pairing ウィジェットの設定メニューにあるウィジェットの設定パネルの外観セクションでは、Workshop アプリケーションでのウィジェットの表示動作をカスタマイズできます。

表示名： ペアリング時にほかのアプリケーションから発見できるように、ウィジェットの名前を設定します。デフォルトでは Workshop アプリケーションの名前が表示されます。 自動オープンモード： デフォルトでは無効になっているため、App Pairing メニューは選択時にのみ開きます。App Pairing メニューを自動的に開き、ペアリングするアプリケーションの選択をユーザーに求める場合は、自動オープンモードを有効にできます。ほかの設定オプションには、以下があります。

• 有効：メニューは初回と、アプリケーションのペアリングが変更されたときの両方で開きます。
• 初回のみ：メニューはアプリケーションが読み込まれたときにのみ開きます。
• ペアリング変更時のみ：メニューは現在ペアリングされているアプリケーションが変更されるたびに開きます。

トーストを有効にする： デフォルトでは無効ですが、トーストを有効にすると、ほかのアプリケーションが現在のアプリケーションとペアリングされたときに、アプリケーションのユーザーに通知できます。エラーの識別情報とトラブルシューティングの手順を提供するトーストは、トーストを有効にするをオフにしても常に表示されます。

更新を一時停止する切り替えを有効にする： デフォルトでは無効ですが、有効にすると、ウィジェットで状態の更新の送受信を一時停止し、再開できます。一時停止後に更新を再開すると、ウィジェットは最新の状態に同期されます。

変数の更新時にコマンドをトリガーする

アプリケーション内の変数が更新されたときに、ほかのアプリケーションに発行するコマンドをトリガーするには、App Pairing ウィジェットの設定メニューにあるウィジェットの設定パネルの変数の更新時にコマンドをトリガーするセクションを使用します。

詳細設定を適用する

ウィジェット設定パネルからアクセスできる以下の詳細設定を使用して、App Pairing の動作をカスタマイズできます。通常は自動化されている機能を制御できます。また、既存の組み込み変数がユースケースに適していない場合はカスタム変数を作成したり、スコープ変数を使用してどのアプリケーションを互いにペアリングするかを手動で管理したり、Workshop とペアリングされた Gaia マップまたは Graph 分析との間のデータエンリッチメントを無効にしたりできます。

ウィジェットの設定パネルの共有された状態変数セクションでは、アプリケーション内で渡されるデータがウィジェットのデフォルトの変数タイプに準拠していない場合に、カスタム変数を作成できます。

メディアタイプ String テキストボックスにメディアタイプ文字列または別の変数のデータ型を入力して、カスタムデータ型を指定します。

Workshop は、以下の変数のデータ型をサポートしています。

• ブール値
• 日付
• 数値
• 数値配列
• 文字列
• 文字列配列

また、カスタム状態変数の設定により、Palantir が既存のプリセットを更新しなくても、App Pairing ウィジェットで将来のアプリケーション統合をサポートできます。

ペアリングされたアプリケーションと Workshop が互いに対応する状態ペイロードを渡していることが確実な場合は、ウィジェットの設定パネルの詳細セクションでデータの強化を無効にするを選択できます。Gaia と Graph は、どちらも Object Synonym RIDs set 変数タイプを Workshop と同期するために、エンリッチメントを必要とします。

また、どのアプリケーションを互いにペアリングするかを手動で調整する場合は、スコープIDを設定できます。Workshop によって自動生成されるスコープID変数を使用し、すべてのアプリケーションが同じスコープに属するようにして、ペアリングを有効にします。スコープID変数を使用して Workshop ウィジェットをスコープに追加できます。また、Workshop 以外のアプリケーションの URL に &appPairingScopeId=[scope-id] を追加して、そのアプリケーションをスコープにリンクできます。アプリケーションを手動でペアリングまたはペアリング解除すると、スコープが変更されます。