アクションパラメーター
アクションパラメーターは、JSON オブジェクトパラメーターが HTTP GET または POST 要求の一部である場合に実行するアクションを指定するため、データパラメーターとは別個です。
パラメーターは、指定された JSON オブジェクトのフィールドとして指定することもできます。sysparm_actionの場合はアクションをトリガーし、sysparm_queryの場合は更新またはクエリの結果をフィルタリングする効果があります。
sysparm_action
sysparm_action と対応するアクションの有効な値は次のとおりです。| メソッドの概要 | 説明 |
|---|---|
| getKeys | エンコードされたクエリ文字列を使用してターゲットテーブルをクエリし、 sys_id 値のカンマ区切りリストを返します。 |
| レコードを取得 | エンコードされたクエリ文字列を使用してターゲットテーブルをクエリし、一致するすべてのレコードとそのフィールドを返します。 |
| 取得 | sysparm_sys_id URL パラメーターでsys_idを指定してターゲットテーブルから単一のレコードをクエリし、レコードとそのフィールドを返します。 |
| メソッドの概要 | 説明 |
|---|---|
| insert | URL でターゲットとなるテーブルの新しいレコードを 1 つ以上作成します。 |
| insertMultiple | URL でターゲットとなるテーブルに対して複数の新しいレコードを作成します。 |
| update | エンコードされたクエリ文字列でフィルタリングされた URL のターゲットテーブルの既存のレコードを更新します。 |
| レコードを削除 | sysparm_sys_id URL パラメーターでレコードのsys_idを指定して、URL でターゲットとなるテーブルからレコードを削除します。 |
| deleteMultiple | エンコードされたクエリ文字列でフィルタリングされた、URL でターゲットとなるテーブルから複数のレコードを削除します。 |
sysparm_query
get、getRecords、update、または deleteMultiplesysparm_action 値で使用するエンコードされたクエリ文字列を指定します。
sysparm_view
フォームビューを指定して、get および getRecords 関数呼び出しの戻り値をカスタマイズします。ビューを使用する場合、クエリは参照値を含むビューで定義されたフィールドのみを返します。ビュー名がない場合、またはビュー名が有効でない場合、クエリーは辞書でアクティブとマークされているすべてのフィールド名を返します。
sysparm_sys_id
get または delete 関数呼び出し中にターゲットsys_idを指定します (sysparm_action 値)。
sysparm_record_count
整数値を指定して、この要求に対して取得されるレコードの数を制限します。この値は glide.processor.json.row_limit システムプロパティによって制限されることに注意してください。
displayvalue
参照フィールドの表示値を取得します (レコードに存在する場合)。たとえば、インシデントレコードには、ユーザーレコードへの参照である assigned_to フィールドを含めることができます。ユーザーレコードのsys_idが送信される代わりに、ユーザー名が送信されます。
- true:すべての参照フィールドに、
sys_idではなく表示値が表示されます。 - false (デフォルト):すべての参照フィールドに
sys_idsが表示されます。 - all:表示値と
sys_idが表示されます。たとえば、インシデントレコードの assignedto フィールドは、assigned_to:1234556、dv_assigned_to:Fred Luddy として返されます。
表示変数
このレコードに添付されているすべての変数を取得するには、get または getRecords 関数呼び出し中にこのブール値を true に設定します。