リアルタイム フォーム

リアルタイム フォーム機能により、使用しているフォームを閉じることなくその値を変更できます。つまり、フォーム フィールドにリンクしている変数は使用中でも容易に変更でき、その際、ワークフローを終了して再度実行するという必要がありません。

この機能を利用するには、[フォームを作成] アクティビティの [実行] ブロックに目的のアクティビティをドラッグ アンド ドロップします。フォームのフィールドとボタンを、[実行] ブロックのアクティビティとリンクするように設定します。

リアルタイム フォームを使用する

[実行] ブロックのアクティビティが、フォームのフィールドに対して実行されます (データの読み取りと書き込みの両方)。これらのアクティビティは、ボタンをクリックしたとき、あるいは任意でフォームを開くと常にトリガーされます。アクティビティの実行中にフォームは開いたままになり、エンドユーザーによる編集が可能になります。

[実行] ブロックをトリガーする

フォームの [実行] ブロックのアクティビティをトリガーするには、ボタンを使用します。

既定では、ボタンによって [実行] ループがトリガーされ、フォームが閉じます。

[実行] ループをトリガーし、値が更新された状態でフォームを開いたままにするには、目的のボタンの [フィールド キー] タブにカスタム プロパティ (キーと値のペアである closeOnSubmit-false) を追加する必要があります。

フォームのどのボタンが使用されたかを確認するには、出力オブジェクトの [選択済みボタン] プロパティを解析します。

フォーム値を更新する

フォームの値は、[実行] ブロック内の対応する変数を変更することによって更新できます。

チュートリアル

[Username (ユーザー名)] と [City (市区町村)] の 2 つのコンポーネントで構成する簡単なフォームを作成してみます。

1. シーケンス ワークフローに [フォームを作成] アクティビティをドラッグ アンド ドロップします。

2. [変数] パネルを開き、コンポーネントごとに 1 つずつ、2 つのグローバル変数を作成します。

   

3. [フォームを作成] アクティビティの [フォーム フィールド コレクション] プロパティで、各コンポーネントに String 型の入力/出力引数を追加し、前に作成したグローバル変数を参照します。こうすることで、コンポーネントがフォーム内で自動生成されます。

   

   リアルタイム フォーム機能を使用するには、クリックしてもフォームが閉じないボタンをフォームに作成します (更新ボタンなど)。

4. フォーム デザイナーを開きます。

5. ボタン コンポーネントをドラッグ アンド ドロップします。

6. ボタン コンポーネントの [フィールド キー] タブに移動します。[カスタム プロパティ] の下で、closeOnSubmit を [キー] として追加し、[値] を false に設定します。 フィールド キーに設定する名前に注意してください。この名前は、フォーム内のコンポーネントのバインドに使用され、大文字と小文字が区別されます。 このボタンを作成すると、[条件分岐 (if)] などのアクティビティを使用して、フォーム内の値またはフォームの背後にあるデータベースの値をリアルタイムで変更できます。

7. ビジネス ユーザーがクリックしたボタンを追跡するには、そのボタンを格納する変数を作成します。 [フォームを作成] アクティビティの [プロパティ] パネルの [出力] カテゴリ>> [SelectedButton] フィールドで、ボタンをクリックしてボタンの変数を作成します。代わりに、 CTRL + K のキーボード ショートカットを使用して変数を作成します。変数は、シーケンス ワークフローの [変数 ] パネルにも追加されます。

8. ボタンの変数に名前を付けます (btn など)。

   

   [条件分岐 (if)] アクティビティでフォーム固有のボタンを使用するには、btn = " ... " 式を使用してボタンを参照します。選択したプログラミング言語 (C# または VB.NET) に応じて、正しい構文を使用してください。この例では、フォームの [更新 ] ボタンを監視します。

9. [フォームを作成] アクティビティの [実行] ブロックに [条件分岐 (if)] アクティビティをドラッグ アンド ドロップします。

10. [ 条件 ] フィールドに、式「VB.NET を使用している場合は btn = "{button_field_key_name}" 、C# を使用している場合は btn == "{button_field_key_name}" を入力します。{button_field_key_name}値を、手順 6 で設定した値に置き換えます。その後、この条件のルールを作成できます。たとえば、[更新] ボタンがクリックされたら、[ユーザー名] フィールドにDatabase Updatedを表示するとします。

    • [条件分岐 (if)] アクティビティ > [Then] セクションに、[代入] アクティビティをドラッグ アンド ドロップします。
    • [代入] アクティビティの [左辺値 (To)] フィールドに、フォームの [Username] フィールドを参照するために使用するグローバル変数を入力します。
    • [値] フィールドに "Database Updated" を入力します。

    

    これで、フォームを実行するだけでリアルタイムの変更が可能になります。フォームを閉じてもう一度開くといった手順は不要です。

サンプル ワークフロー

ワークフロー全体を確認するか、今後の参考にするには、以下のアーカイブ済みの例をダウンロードしてください。