› ユーザー インターフェイス › フォーム › フォーム イベントとアクション › フォーム アクション › コントロールの更新アクション

コントロールの更新アクション

コントロールの更新アクションを使用して、作業キュー、ジョブ リスト、およびシステム クエリの結果リストを再読み込みおよびリフレッシュします。

このアクションは、タッチ対応の電話およびタブレット用のフォームでは使用できません。これらのフォームは、作業キュー、ジョブ リスト、およびワークロードのコントロールをサポートしていないためです。

デフォルトでは、次のドリルダウン プロパティをジョブ リスト、作業キュー、およびワークロードのコントロールで使用できます。

  • DynamicQueryId: クエリの一意の識別子。

  • DynamicFilterField: フィルタが適用されるフィールド タイプ。

  • DynamicFilterValue: フィルタの更新に使用されるフィールドの値。

  • DynamicQueryName: クエリの名前。

  • DynamicQueryType: クエリのタイプ。

  • CurrentQueryID: 現在のクエリの ID。

  • CurrentQueryName: 現在のクエリの名前。

  • CurrentQueryType: 現在のクエリのタイプ。

これらのフィールドの詳細については、列挙を参照してください。

同じページ アクションなどのアクションで、クエリ ID、クエリ名、クエリ タイプ、フィルタ フィールド、フィルタ値を動的に設定し、コントロールの更新アクションを使用すると、指定した変更に基づいて結果を表示できます。

クエリ ID の代わりにクエリ名とクエリ タイプを指定できます。クエリ タイプを指定しない場合は、コントロールに関連付けられたクエリ タイプがランタイムに使用されます。クエリ ID は、QueryName フィールドと QueryType フィールドよりも優先されます。

現在のクエリ ID、クエリ名、クエリ タイプの各プロパティは、現在設定または選択されているクエリを反映しており、読み取り専用です。これらのプロパティは設計時には設定できません。

  • アクションを使用して、動的クエリ ID、クエリ名、クエリ タイプの各プロパティを設定し、同じアクションを使用して現在のクエリ ID、現在のクエリ名、クエリ タイプの各プロパティを取得した場合、返される値は同じになります。

  • コントロール (ジョブ リスト、作業キュー、またはワークロード) の [クエリ編集を許可] 設定をクリアして、ランタイムにコントロールを表示すると、別のクエリを選択するときに、これらのプロパティが設定されます。

クエリには、複数の動的フィルタを設定できます。ただし、これらは自動的には適用されません。UpdateControl アクションを呼び出すときにブロックとして適用されるだけです。

たとえば、アクティビティ名と優先度 3 でクエリをフィルタ処理するには、次のように設定します。

DynamicFilterField = 5

DynamicFilterValue = 'ActivityName'

DynamicFilterField = 7

DynamicFilterValue = 3

次に、コントロールの更新アクションを呼び出します。

  1. フォーム モデリング バーで、[アクション] をクリックし、[新規] をクリックします。

    [新しいアクション] ダイアログ ボックスが表示されます。

  2. [タイプ] リストで、[更新コントロール] を選択します。
  3. デフォルトの [名前] (UpdateControl1) を意味のある名前に変更します。
  4. この項目は任意です。アクションの [説明] を入力します。
  5. この項目は任意です。[複数言語] を選択して、言語ごとに固有のアクションを個別に構成します。複数言語の設定アクションを参照してください。
  6. [コントロール] リストで、コントロールを選択します。
    ジョブ リスト、作業キュー、およびワークロードのコントロールのみ選択できます。
  7. [追加] をクリックします。

    新たに作成されたアクションがフォームに追加されます。

  8. このアクションをトリガーするため、アクションにコントロール (ボタンなど) を関連付けます。フォーム コントロール イベント用のアクションの構成を参照してください。
    このアクションをトリガーする際、クエリ結果は次の基準に基づいて更新されます。

    • コントロールにクエリ ID を設定すると、クエリ ID で識別されるクエリ結果が表示されます。

    • クエリ ID、フィルタ フィールド、およびフィルタ値をコントロールに設定すると、ID で識別され、フィルタ フィールドとフィルタ値の組み合わせを満たすクエリ結果が表示されます。フィルタ フィールドとフィルタ値を設定するたびに、アクションのトリガー時に同じクエリが更新され、クエリ ID が削除されても表示されます。フィルタ フィールドの値は、クエリ エディタでそのフィールドに設定された値に対応していることが必要です。フィルタ フィールドとフィルタ値の組み合わせが無効な場合はエラーが発生します。

    • 別のクエリを表示するには、クエリ ID を変更する必要があります。

    • クエリが現在のリソースと共有されていない場合、クエリ名はランタイムにクエリ パネルに表示されません。

こちらも参照してください。