パラメーターのドロップダウンの結果をフィルター処理する

非オブジェクト参照の複数選択または単一オブジェクト参照パラメーターにフィルターを追加すると、パラメーターのドロップダウンで選択可能な許可された値が決定されます。

複数選択パラメーターのドロップダウン

複数選択パラメーターのドロップダウンを設定する際、アクションのエディタは、許可された値をオブジェクトセットのプロパティだけに制限することができます。これを利用して、リンクされたオブジェクトのプロパティに基づいて値を表示したり、事前に入力したりすることができます。これを実現するためには、パラメーターが複数の選択肢を表示するように設定されていることを確認し、オブジェクトセットからオプションを取得するを選択し、目的のオブジェクトセットを設定し、パラメーターのドロップダウンのすべての許可された値を含むプロパティを選択します。結果のオブジェクトセットにリンクされたオブジェクトが一つだけで、パラメーターが必須である場合、パラメーターのドロップダウンは自動的に対応するプロパティ値で事前に入力されます。結果の複数選択のオプションは、ユーザーが閲覧することが許可されているオブジェクトのセットから導出されます。つまり、オブジェクトセットから複数選択のオプションを導出する際、ユーザーはアクセス権がないオブジェクトのプロパティは見ることができません。

オブジェクトのドロップダウン

パラメーターの設定ビュー内で、アクションのエディタは、すべてのアクションインターフェースでドロップダウンに表示されるオブジェクトを制限するためのフィルターと検索を指定することができます。フィルターを設定した後、アクションのフォームは、フィルターに一致するオブジェクトだけを持つドロップダウンをレンダリングします。選択された値もアクションが実行される前に検証されます。

例えば、名前が Name パラメーターの値と等しい 株式シリーズ のみを表示するように設定されたオブジェクトのドロップダウン。

以下の画像は、 Name パラメーターの可能な値を示しています：

データプライバシーの影響

オブジェクトパラメーターに新しい検証を使用すると、アクションタイプを表示できる全員がデータを見ることが可能になります。パラメーターフィルターに機密性の高い静的値がある場合、ユーザーはフィルター処理されている基礎となるオブジェクトを見ることができなくても、それらの値を見ることができます。データプライバシーの影響について詳しく学びましょう。

サポートされる操作

プロパティに対するフィルター処理

オブジェクトのドロップダウンは、指定したプロパティが提供された値のいずれかと一致するオブジェクトだけを表示します。

値は、ユーザーによって静的に定義されるか、別のパラメーターから推測されるか、または Object Reference パラメーターのプロパティであることができます。比較対象の値が複数提供された場合、結果は OR 操作になります。

開始オブジェクトセットの変更

クエリの 開始セット はデフォルトでオブジェクトタイプのすべてのオブジェクトに設定されていますが、これは他のタイプに変更することができます。開始セットはまた、 ObjectReference リストパラメーターに設定することもできます。

検索

検索は、現在のセットのすべてのオブジェクトでリンクをたどって新しいセットを作成します。例えば、 Github Issue of Current Employee は現在のセットの Employees を取り、それらの Employees にリンクされた Github Issues の結果セットを作成します。