インターフェースに対するアクション

選択したインターフェースのすべてのオブジェクトに適用される汎用アクションを作成できます。アクション内でインターフェースを使用する主な方法は2つあります。

• インターフェースアクションルール： 設定されたインターフェースのオブジェクトを作成、変更、削除、リンクします。
• インターフェース参照パラメーター： 設定されたインターフェースのオブジェクトを参照します。このパラメーターは「変更」および「削除」のインターフェースアクションルールで必須ですが、ほかのアクションルールでも使用できます。

インターフェースでは、インターフェースのアクションタイプ制約も定義できます。この制約は、インターフェースを実装するオブジェクトタイプが具体的なアクションタイプで満たすことのできる、期待されるアクション機能を記述します。

アクションタイプ制約はインターフェースレベルのアクション契約を定義し、アクションルールはアクションタイプの実行時に行われる編集を定義します。

インターフェースのアクションタイプ制約は、現在、Ontology Manager のモデリングおよびマッピング機能であり、エンドユーザー向けのアプリケーションやオントロジー SDK の呼び出し手段ではありません。

インターフェースに対するアクションルールを使用する

編集内容を、インターフェースを実装するすべてのオブジェクトタイプに適用できる場合は、インターフェースアクションルールを使用できます。つまり、インターフェースアクションルールは、インターフェースの共通プロパティの変更、またはオブジェクトの削除にのみ使用できます。たとえば、「機能リクエスト」と「バグ」が「チケット」インターフェースのオブジェクトタイプである場合、「チケットを作成」アクションタイプを使用してバグや機能リクエストを作成できますが、バグや機能リクエストに固有のプロパティタイプは作成できません。

新しいインターフェースアクションタイプを作成する

新しいインターフェースアクションタイプを設定するには、Ontology Manager の新規メニューからアクションタイプを選択します。

1. インターフェースで、目的のインターフェースとルールの種類を選択します。

2. アクションに含める共通プロパティを追加します（該当する場合）。
3. アクションタイプを説明するメタデータを追加します。このメタデータは、インターフェースを実装するすべてのオブジェクトタイプに適用される必要があることに留意してください。
4. 実行条件で、アクションを実行できるユーザーを選択します（より複雑な条件は後から適用できます）。ユーザーに編集権限がある限り、これらの権限はインターフェースを実装するすべてのオブジェクトタイプに適用されることに留意してください。
5. 作成を選択して、アクションタイプを確定します。

インターフェースに対する「作成」アクション

アクションタイプはインターフェースにのみ関連付けられるため、作成するオブジェクトタイプを指定する「オブジェクトタイプ」パラメーターが自動的に生成されます。フォームまたはテーブルを使用する場合、ユーザーがリストからオブジェクトタイプを選択するための入力画面が表示されます。

主キーがないオブジェクトは作成できません。そのため、ルール内で主キーが割り当てられていないオブジェクトタイプでは、実行時に失敗します。このような失敗を避けるため、インターフェースと作成ルールの両方に、インターフェースを実装するオブジェクトタイプで主キーとして使用できるインターフェースプロパティが含まれていることを確認してください。

インターフェースに対する「変更」アクション

インターフェースの「変更」ルールでは、設定したインターフェースの任意のオブジェクトを変更できます。選択したインターフェースに限定された「インターフェース参照」パラメーターが生成されます。「インターフェース参照」パラメーターは「オブジェクト参照」パラメーターと似ていますが、インターフェースを実装する任意のタイプのオブジェクトを表示する点が異なります。フォームまたはテーブルを使用する場合、ユーザーはリストからオブジェクトを選択できます。

主キーの値は、どのアクションタイプでも変更できません。そのため、選択したオブジェクトタイプの主キープロパティをアクションが変更しようとすると、実行時に失敗します。インターフェースを実装する一部のオブジェクトタイプで主キーとして使用される可能性があるプロパティを、アクションルールが変更しないことを必ず確認してください。

以下の例では、「タイトル」プロパティが「バグ」オブジェクトタイプの主キーとして誤って使用されています。「チケットを編集」アクションは、バグの主キーを変更しようとするため、実行時に失敗します。

インターフェースに対する「削除」アクション

「削除」アクションルールには、オブジェクト参照パラメーターの代わりに「インターフェース参照」パラメーターを割り当てることができます。このインターフェース参照は特定のインターフェースに限定され、削除するオブジェクトを指定します。フォームまたはテーブルを使用する場合、ユーザーはリストからオブジェクトを選択できます。

インターフェースに対する「リンクを作成」アクション

「インターフェースリンクを作成」ルールでは、インターフェースで定義されたインターフェースリンク制約を使用してリンクを作成できます。「インターフェースリンクを作成」ルールを設定するには、次の手順に従います。

1. リンクを作成するインターフェースを選択します。
2. インターフェースで定義されたインターフェースリンク制約を選択します。リンク制約が2つのインターフェース間にある場合、ソースと宛先のパラメーターはどちらもインターフェース参照パラメーターとして自動的に生成されます。リンク制約がインターフェースとオブジェクトタイプの間にある場合、ソースはインターフェース参照パラメーター、宛先はオブジェクト参照パラメーターになります。

アクションによって自動生成されるパラメーターを使用しない場合は、必要に応じてソースと宛先のオブジェクトを手動で設定することもできます。これらには、次のいずれかを使用できます。

• 既存のオブジェクトを参照するインターフェース参照パラメーターまたはオブジェクト参照パラメーター。
• 同じアクションタイプ内の「オブジェクトを作成」または「インターフェースのオブジェクトを作成」ルールで作成されるオブジェクト。

インターフェースに対する「リンクを削除」アクション

「インターフェースリンクを削除」ルールでは、インターフェースで定義されたインターフェースリンク制約を使用してリンクを削除できます。「インターフェースリンクを削除」ルールを設定するには、次の手順に従います。

1. リンクを削除するインターフェースを選択します。
2. インターフェースで定義されたインターフェースリンク制約を選択します。リンク制約が2つのインターフェース間にある場合、ソースと宛先のパラメーターはどちらもインターフェース参照パラメーターとして自動的に生成されます。リンク制約がインターフェースとオブジェクトタイプの間にある場合、ソースはインターフェース参照パラメーター、宛先はオブジェクト参照パラメーターになります。

必要に応じて、自動生成されるパラメーターを使用する代わりに、ソースと宛先のオブジェクトを手動で設定することもできます。これらは、既存のオブジェクトを参照するパラメーター、つまりインターフェース参照パラメーターまたはオブジェクト参照パラメーターである必要があります。

インターフェースに対するアクションを実行する

インターフェースアクションルールで作成されたアクションは、オブジェクト固有のアクションタイプと同様に、インターフェースを実装するオブジェクトタイプのオブジェクトに適用できます。あるオブジェクトに対して適用できる、オブジェクトタイプ固有のアクションとインターフェースベースのアクションは、すべてアクションのドロップダウンに表示されます。

権限

インターフェースアクションルールは、オブジェクトのアクションタイプと同じ権限に従います。

詳細については、アクションタイプの権限に関するドキュメントを参照してください。

サポートレベル

インターフェースアクションルールと参照パラメーターのサポートが拡大するにつれて、Palantir プラットフォーム内で利用可能な範囲は異なります。

サポートされるアプリケーションとサービス

• Ontology Manager: インターフェースアクションタイプの作成、および実行条件とオーバーライドでのインターフェースパラメーターの設定。
• Object Explorer と Object View： インターフェースで定義されたアクションの表示。

インターフェースアクションルールの制限事項

• 実行条件は、インターフェースを実装するすべてのオブジェクトタイプに一律に適用されるため、単一のインターフェースアクション内でオブジェクトタイプごとに異なる権限を設定することはできません。アクセスを制限するには、Ontology Manager でインターフェースタブを選択し、インターフェースアクション制御セクションでインターフェースから継承したアクションの制御を設定して、特定のオブジェクトタイプのインターフェースアクションを無効にします。インターフェースアクションに、よりきめ細かい権限制御を適用する機能は現在開発中です。
• アクションログはまだサポートされていません。
• インターフェースに対するアクションは、関数と併用できません。