ルール - Automate_Evolve - Automate_Studio_Manager - 20.3

Automate Evolve ユーザー ガイド

Product type
ソフトウェア
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Evolve
Version
20.3
Language
日本語
Product name
Automate Evolve
Title
Automate Evolve ユーザー ガイド
Topic type
管理
概要
リファレンス
First publish date
2018

このページでは、ルールを操作するための次の方法について説明します。

ルールは、ロジックを制御し、別のフィールドのデータが変更されたときに 1 つのフィールドを自動的に更新するなど、フォーム内の機能を自動化するのに役立つ強力なツールです。ルールでは、数式をデータに適用したり、データを変更したり、フォーム内のデータの外観を変更したりできます。

たとえば、ルールを使用して、データベースに対する検索、Web サービスのアクティブ化、フィールド値の設定など、特定の機能をボタンでトリガーするようにします。また、ルールを使用して、フィールドの色を赤に変更して誤った値を示すことにより、データの誤入力を警告することもできます。

高度なルールの場合

ソリューション ビルダーがルールの作成に必要な柔軟性を提供しない場合、上級者のユーザーはカスタム JavaScript を使用してルールを作成できます。サポートされている JavaScript ラッパー、構文などについては、JavaScript リファレンス ガイド を参照してください。

ルール アクション

注:

すべてのルールは、1 つ以上のアクションで構成されます。上記の例では、単一のルールを使用して両方の関数を処理できます。各関数は個別のアクションになります。たとえば、ルールを使用して、ユーザーが項目の価格フィールドと数量フィールドに入力した値に基づいて、合計価格フォーム フィールドを自動的に計算して更新できます。

フィールドまたはボタンに複数のルールを適用する場合、次のアクションは 1 回しか使用できず、シーケンスの最後のルールである必要があります

  • クエリの実行
  • Web サービスの実行
  • フォームの送信

これは、サーバーに対してリクエストが行われるため、リクエストが行われると追加のルールを実行できないためです。

注:

ルールが適用されたフィールドは、[ソリューション] タブの [ソリューション] ペインで名前の横にチェック アイコンが表示されます。例:

ルールは、ルール タイプ (アクション、フォーマット、または検証)、1 つ以上の条件、または 1 つ以上のアクションで構成されます。

新しいルールの追加

  1. [プロパティ] ペインで [プロパティ] をクリックします。
  2. [プロパティ] タブの [ルール] の横にある [オプション] [...] ボタンをクリックします。
  3. [プロパティ] ペインに [ルール インスペクター] が開きます。
  4. [ルールの追加] をクリックします。
  5. ルールの情報を以下のように入力します。
    • ラベル: ルールのわかりやすい名前を入力します。
    • フォームの読み込み時にルールを実行: フォームが読み込まれてすぐにルールを実行するには、これを選択します。
    • タイプ: ルール タイプ (検証、フォーマット、またはアクション) を選択します。
    • 条件: クリックして、特定のフォーム フィールドが変更されたときなど、ルールがトリガーされる条件を作成します。詳細は、条件の使用 (以下) を参照してください。
    • メッセージ: ルールの実行時にユーザーに表示するメッセージを入力します。
    • ポップアップを使用する: ポップアップを使用してユーザーにメッセージを表示するには、このボックスをオンにします。
    • ポップアップ タイトル: [ポップアップを使用] を選択した場合は、このフィールドにポップアップ ウィンドウの名前を入力します。
  6. [OK] をクリックして終了します。

既存のルールの変更または削除

変更するルールがあるフィールドまたは要素をクリックします。

  1. [プロパティ] ペインで [プロパティ] をクリックします。
  2. [プロパティ] タブの [ルール] の横にある [オプション] [...] ボタンをクリックします。
  3. ルール エディタで:
    • [追加] をクリックしてルール アクションを追加します。
    • [編集] アイコンをクリックして、エディターでルールを開きます。
    • [削除] (ゴミ箱) アイコンをクリックして、ルールを削除します。
    • [条件] をクリックして、ルール条件を変更します。詳細は、条件の使用 (以下) を参照してください。
    • [条件の削除] (ゴミ箱) をクリックして、条件を削除します。
  4. [OK] をクリックして変更を終了します。

ルール インスペクターの使用

ルール インスペクターを使用して、ソリューション内のすべてのルールのスナップショットまたは「ダッシュボード」を取得します。

ルール インスペクターから、次のことができます。

  • 検索バーで特定のルールを検索して、結果をフィルタリングします。
  • 結果を印刷します。
  • 名前をクリックして ルールを編集 します。
  • フィールドの名前をクリックして、フィールドに適用されているすべてのルールを表示します。

条件の使用

[条件ビルダー] は、条件のロジックとルールを作成するためのシンプルなグラフィカル インターフェイスを提供します。

  • [条件を追加] をクリックして、条件を追加します。
  • [グループを追加] をクリックして、条件のサブグループを追加します。
  • ドロップ ダウン メニューから [フォーム フィールド] と論理演算子 (「is equal to」や「not equal to」など) を選択します。
  • 条件またはグループを削除するには、[削除] をクリックします。

下: ルール条件ビルダーの条件例

ルールのタイプ

ルールには、次の 4 つの基本的なタイプがあります。検証フォーマットアクション、および JavaScript (JavaScript ルールの詳細については、JavaScript リファレンス ガイドを参照してください)。各タイプのルールは、一般的なプロパティの共通セットによっても管理されます。

次の詳細については、以下を参照してください。

一般ルール プロパティ

フォームの読み込み時にルールを実行フォームが読み込まれたときにルールをすぐに実行する必要があるかどうかを示します。

このルールを実行する前に、デバッガーで実行を停止してください

このオプションは、ルールのトラブルシューティングに適しています。このオプションを有効にすると、ルールを実行する直前に JavaScript コードにデバッグ ブレークポイントが挿入されます。ブラウザ開発ツールがアクティブで、このルールが実行されると、コードをさらに問い合わせるために、ルールを実行する直前にブラウザのデバッグ セッションが停止します。

ルールの無効化

このオプションを有効にすると、フォームの実行時にルールの実行が停止します。

タイプ 作成するルールのタイプを指定します。選択したルールのタイプに応じて、追加のオプションが表示されます。詳細は、以下を参照してください。

  1. 検証
  2. フォーマット
  3. アクション

条件 指定された条件 条件true の場合、このルールが実行されます。それ以外の場合、このルールは実行されません。

注:

 リファレンス データ リストの Yes/No 列と比較するために条件を使用する場合 Yes/No 列: 値は True または False である必要があります。 (引用符などは除きます。) 最初の文字は 大文字にする必要があります。つまり、True または False であり、true/false ではありません。

1. 検証ルール

検証ルールを使用して、フォーム フィールドに入力されたデータが無効な場合にエラー メッセージを表示できます。エラー メッセージが表示される条件を指定できます。

たとえば、フィールドに入力された数値が特定の値より大きいか、特定の値より小さいか、またはその両方である場合にエラーを表示するルールを作成できます。

  • ラベル: ルールを説明するラベル。
  • フォームの読み込み時にルールを実行: フォームが最初に読み込まれたときにルールを実行するには、これをチェックします。
  • 条件: クリックしてルール条件クリエーターを開き、ルールが有効になる条件を定義します。条件は、基本的な値の比較である場合もあれば、複雑な式を含む場合もあります。
  • タイプ: ルールのタイプ。
  • エラー メッセージ: 定義した条件が満たされたときに表示するエラー メッセージ テキスト。
  • ポップアップを使用: フォームでエラーを強調表示する代わりに、検証メッセージを含むダイアログ ボックスを表示します。このオプションは、メッセージを表示するためにのみ使用されます。フォームを送信する前にルールが検証されることはありません
  • ポップアップ タイトル: ポップアップ ボックスのタイトル。

2. フォーマット ルール

フォーマット ルールは、特定の条件が満たされたときにフォーム フィールドに特定のフォーマットを適用します。

たとえば、フォーム フィールドに入力された値が高すぎる場合は、フォーム フィールドを黄色に変更するルールを作成できます。

  • ラベル: ルールを説明するラベル。
  • フォームの読み込み時にルールを実行: フォームが最初に読み込まれたときにルールを実行するには、これをチェックします。
  • 条件: クリックしてルール条件クリエーターを開き、ルールが有効になる条件を定義します。条件は、基本的な値の比較である場合もあれば、複雑な式を含む場合もあります。
  • タイプ: ルールのタイプ。
  • フィールドにスタイルを適用: フォーマットが適用されるフィールド。
  • フォーマット オプション: フォントと色のオプション: 太字、斜体、下線、線条体の背景とテキストの色。
フォント スタイルの変更

フォント スタイルの変更 (このフィールドにフォーム コンポーネントを適用するため):

  • 太字
  • 斜体
  • 下線
  • 取り消し線
  • 背景のカラー
  • テキスト色
フォーム コンポーネントの変更
フィールドを非表示、必須、または無効にするには、[フィールド プロパティの変更] を使用してアクション ルールを作成します。詳細については、「アクション ルール - クイック リファレンス テーブル」の「フィールド プロパティの変更」のエントリを参照してください。
  • コンポーネント グループを非表示: 条件が true の場合、フィールドを含むグループ全体を非表示にします。
  • コンポーネントを非表示: 条件が true の場合、フィールドとそのラベルを非表示にします。
  • このコンポーネントを無効化: 条件が true の場合、フィールドを無効にします。
  • コンポーネントが必須: 条件が true の場合、フィールドを必須に設定します (つまり、フィールドが空の場合、フォームを送信できません)。

3. アクション ルール

アクション ルールは最も用途の広いルールです。アクション ルールは、特定のフィールドでの値の設定、フィールドでの値の比較、数式に基づく値の計算など、さまざまな機能を実行できます。

  • ラベル: ルールを説明するラベル
  • フォームの読み込み時にルールを実行: フォームが最初に読み込まれたときにルールを実行するには、これをチェックします。
  • 条件: クリックしてルール条件クリエーターを開き、ルールが有効になる条件を定義します。条件は、基本的な値の比較である場合もあれば、複雑な式を含む場合もあります。
  • タイプ: ルールのタイプ。
  • 追加: クリックしてルールを追加し、[ルール アクションを追加] ダイアログボックスを開きます (以下を参照)。

[アクション] ルールの基本情報と条件を指定した後:

  • アクション: ドロップ ダウン メニューからアクションを選択します。ルール アクションの説明については、以下のルール クイック リファレンス テーブルを参照してください。
  • フィールド: アクションが適用されるフィールドを選択します。フィールドの名前を入力して、フィールドを自動的に検索することもできます。
  • : 値を入力するか、f (x) (関数) をクリックして、アクションの一部として実行される数式を挿入します。

アクション ルール - クイック リファレンス テーブル

各アクション ルールの機能と、アクションに関連付けられているパラメーターの説明については、以下を参照してください。

アクション 説明

新しい行の追加

繰り返しテーブルまたはグループに新しい行を追加します。

パラメーター

  • グループ: 新しい行が追加される繰り返しグループ。

フィールド プロパティの変更

フィールド プロパティを変更して、表示/非表示、有効/無効、入力の必要/不要などを設定できます。

パラメーター

  • 利用可能なオプション: 表示 | 非表示 | 有効 | 無効 | 必要 \ 不要
  • フィールド: 変更するフィールド。

グループ表示の変更

グループ内の指定されたフィールドに基づいて、グループを表示、非表示、展開するか、折りたたむかを切り替えます。

パラメーター

  • グループ内のフィールド: 包含グループの表示状態を管理するフィールド データ。(表示 | 非表示 | 展開 | 折りたたみ)
同様の行をコピー

このルールを使用して、1 つの繰り返しテーブルまたは繰り返しグループからターゲットの繰り返しテーブルまたは繰り返しグループに行をコピーできます。

このルールは、ソース繰り返し要素の列値と一致し、セレクター フィールドのプロパティに基づいてコピーする行を決定します。

行のコピー アクションは、一致する行を上書きするか、新しい行としてターゲットの繰り返し要素に追加するかを決定します。

テーブル データをコピー

ソリューション ビルダーのユーザー インターフェイスで使用できる [テーブル データのコピー] ルールを使用して、テーブル間でデータをコピーできます。

この機能にアクセスしたい場合は、詳細について営業アカウント担当者にお問い合わせください。

パラメーター

  • 現在のフィールド/テーブル: [テーブル データのコピー] ルールが適用されるフィールド。(必須)
  • プライマリ ソース: 値のコピー元となるテーブル。これは、定義された条件に基づいて、単一の行または複数の行にすることができます。(必須) フォーム データに存在するすべての繰り返しテーブル/繰り返しグループ/選択可能なテーブルがプライマリ ソース リストに入力されます。
  • 追加ソース: プライマリソースに加えて定義された非繰り返しソース フィールド。(オプション)
  • ターゲット テーブル: データの最終セットがコピーされるテーブルまたは繰り返しグループ。(必須)
  • アクション可能フィールド: 前述のすべてのフィールドは、まとめてアクション可能フィールドと呼ばれます。
  • 条件: コピーする行が選択される条件を定義します。
  • マッピング: ソース フィールドとターゲットフィールド間の関係を定義します。
  • 更新タイプ:
    • 行を上書き: テーブルを消去し、最初の行からデータを書き込めるようにします。データのコピー条件が満たされない場合、ソース テーブルの行はターゲット テーブルにコピーされません。また、ターゲット テーブルが消去されます。
    • 行を追加: 最後に使用可能な行からデータをコピーできます。

注意点と制限事項

  • ソース フィールドとターゲットフィールドの間のデータ タイプは同じである必要があります。繰り返しテーブルの場合、データ タイプ フィールドは入力タイプと呼ばれ、繰り返しグループの場合、データ タイプ フィールドは要素タイプと呼ばれます。例 - ソース テーブルに日付フィールドがあり、テーブル データのコピー ルールを使用してコピーする必要がある場合、ターゲット テーブルも日付フィールドである必要があります。
  • ソース テーブルとターゲット テーブルは常に同じフォーム ビュー (現在) にある必要があります。
  • ソース フィールドからターゲット - 繰り返しグループ (読み取り専用) にデータをコピーする場合、[行を上書き] オプションを選択すると、[テーブル データのコピー] ルールの条件が満たされていない場合でも、削除アイコンが消えます。
  • 次の要素はコピーできません。
    • ラベル
    • 添付ファイル
    • ページネーション付きの選択可能なテーブル
  • ネストされた繰り返しテーブルは、テーブル データのコピー ルールではサポートされていません。
  • ルールは、ターゲット テーブルではサポートまたは実行されていません。

行の削除オプション

  • 有効:「ゴミ箱」(削除) アイコンを表示します
  • 無効: 「ゴミ箱」 (削除) アイコンを非表示にします

パラメーター

  • グループ: 行削除オプションを有効/無効にする繰り返しグループ。

空のテーブル

繰り返しテーブルまたはグループからすべてのデータを消去します。

パラメーター

  • グループ: すべてのデータを消去する繰り返しグループ。

クエリの実行

フォームでクエリ コントロールを実行します。

パラメーター

  • クエリ コントロール: 実行するクエリ。

フィールドのルールを実行

別のフィールドでルールを実行します。これは、2 つのフィールドに相互に関連するルールがある場合に役立ちます。

パラメーター

  • フィールド: ルールを実行するフィールド。

Web サービスの実行

フォームで Web サービス コントロールを実行します。

パラメーター

  • Web サービス コントロール: 実行する Web サービス。

繰り返しコンテンツのフィルタリング

繰り返しテーブル/グループのコンテンツを保持したままフィルタリングを有効にします。「条件」を設定することができます。例: field1="this"、field2 !="that "。条件を満たした行のみが繰り返しテーブル/グループに表示されます。

パラメーター

  • グループ: フィルター基準に基づいてフィルタリングするグループ。
  • フィルター: ドロップ ダウン リストのフィルター ロジックを作成します。たとえば、Is equal to で特定の値を指定する型や、and/or 演算子を指定することができます。フィルターをクリアし、 Is equal to の代わりに contains 演算子を使用して、繰り返しコンテンツをフィルター処理して表示することもできます。

新しい行オプション

  • 有効: 繰り返しテーブル/グループに [新しい行を追加] リンクを表示します
  • 無効: 繰り返しテーブル/グループに [新しい行を追加] リンクを非表示にします

パラメーター

  • グループ: 新しい行オプションを有効/無効にする繰り返しグループ。

ドロップ ダウン オプションの再読み込み

ドロップ ダウン リストまたはコンボ ボックスのオプションを再読み込みします。これは、動的オプション リストに使用できます。

パラメーター

  • フィールド: オプションが再読み込みされるドロップ ダウン フィールド。

マップのレンダリング

フォームのマップ コントロールに新しい住所を送信します。

パラメーター

  • マップ要素: 新しい住所で更新するマップ コントロール。
  • 説明: マップの場所に割り当てる説明。
  • 住所: 新しいマップの場所の住所。
  • : 新しいマップの場所の市。
  • : 新しいマップの場所の州。
  • 郵便番号: 新しいマップの場所の郵便番号。
  • : 新しいマップの場所の国。

繰り返しコンテンツの検索

これにより、すべてのフィールドで「パターン」を検索するメカニズムが提供されます (たとえば、いずれかのフィールドに「abcd」が含まれている場合)。この場合、少なくとも 1 つのフィールドにパターンが含まれているすべての行が、繰り返しテーブル/グループに表示されます。

パラメーター

  • グループ: グループ名
  • 次を含む: フィールド名

フィールド値の設定

このアクションにより、フォームのフィールドの値を変更できます。

パラメーター

  • フィールド: 値を設定するターゲット フィールド。
  • : フィールドの新しい値を取得するために評価する式。これには、他のフィールド値、関数呼び出し、外部データ リファレンス、または定数値が含まれる場合があります。

ラベルの設定

このルール アクションは、フィールド値の設定 (上記) に似ていますが、フォーム要素のラベル (またはサブラベル) を変更します。

パラメーター

  • XPath: フォーム要素のラベル値を変更するフィールド (ドロップ ダウンから選択)。
  • : フィールドの新しい値を取得するために評価する式。これには、他のフィールド値、関数呼び出し、外部データ リファレンス、または定数値が含まれる場合があります
  • サブラベル (True/False): 指定した要素のサブラベルを変更するには、True に設定します。

メッセージの表示

これにより、ルールで指定されたメッセージ テキストを含むポップアップ ボックスが表示されます。このルールのプロパティは、デフォルトでフォームのフィールドから取得されます。

繰り返しコンテンツのソート

繰り返しテーブルの項目をソートします。

パラメーター

  • グループ内のフィールド: ソートする繰り返しコンテンツのフィールド。
  • ソート順: 昇順または降順
  • 持続: True に設定すると、データは異なるビュー間でソートされたままになります。false に設定すると、データは異なるビュー間でソートされたままになりません。

フォームの送信

このアクションにより、フォームの [送信] ボタンをシミュレートできます。

パラメーター

  • 送信タイプ: 送信の処置またはタイプ:
  • 完了 – 現在のタスクを完了します。
  • 承認 – 承認して現在のタスクを完了します。
  • 却下 – 却下して現在のタスクを完了します。
  • 保存 –フォームを保存しますが、プロセスを開始または続行しません。
  • 保存してルーティング –フォームを保存し、プロセスを開始します。