9.12. アクション設定¶

1. イベントタイプ

   初期表示イベント設定の場合は、固定で「ロード」が表示されます。

2. 処理中にインジケータを表示する

   チェックがオンになっている場合、外部連携・アクションの実行中はインジケータが表示されるようになります。

   コラム

   「インジケータ」の表示

   「処理中にインジケータを表示する」の設定を有効にしている場合、以下のように表示されます。

   

3. アクション

   設定しているアクションの種類を表示します。

4. 説明

   外部連携の処理やマッピングについての設定の説明を入力します。

   外部連携でデータソース定義が設定されている場合には、設定済みのデータソース定義名を表示します。

5. 前処理エラー時

   2件以上の外部連携・アクションを登録している場合に、直前に実行する外部連携・アクションがエラーの時にどのように処理を行うかを設定します。

   • 処理を続行する→直前の外部連携・アクションの結果に関係なく、処理を実行します。
   • 処理を中止する→直前の外部連携・アクションの結果がエラーとなった場合、処理を中止します。
   • スキップ→直前の外部連携・アクションの結果がエラーとなった場合、処理をスキップします。

6. 設定

   アイコンをクリックすると、選択されたアクションに応じて、以下の設定画面に遷移します。

   • 外部連携 → 「データマッパー」画面に遷移します。
   • 入力モード変換 → 「入力モード変換設定」画面に遷移します。
   • 表示モード変換 → 「表示モード変換設定」画面に遷移します。
   • カスタムスクリプト → 「カスタムスクリプト設定」画面に遷移します。

7. 条件

   アイコンをクリックすると、「条件設定」画面に遷移します。

8. 削除

   アイコンをクリックすると、登録済みの外部連携・アクション設定を削除します。

1. アイテム

   外部連携・アクションの対象の画面アイテムの「ラベル」、「フィールド識別ID」を表示します。

2. イベントタイプ

   外部連携処理のタイミングとなる画面アイテムのイベントタイプを表示します。

3. アクション

   設定しているアクションの種類を表示します。

4. 説明

   アクションとして設定した内容の説明を入力します。

   外部連携が設定済みの場合には、データソース定義名を表示します。

5. 前処理エラー時

   2件以上の外部連携・アクションを登録している場合に、直前に実行する外部連携・アクションの処理がエラーの時に処理を続行する（次の処理を実行する）か、処理を中止するかを設定します。

   • 処理を続行する→直前の外部連携・アクションの結果に関係なく、処理を実行します。
   • 処理を中止する→直前の外部連携・アクションの結果がエラーとなった場合、処理を中止します。
   • スキップ→直前の外部連携・アクションの結果がエラーとなった場合、処理をスキップします。

6. 設定

   アイコンをクリックすると、選択されたアクションに応じて、以下の設定画面に遷移します。

   • 外部連携 → 「データマッパー」画面に遷移します。
   • 入力モード変換 → 「入力モード変換設定」画面に遷移します。
   • 表示モード変換 → 「表示モード変換設定」画面に遷移します。
   • カスタムスクリプト → 「カスタムスクリプト設定」画面に遷移します。

7. 条件

   アイコンをクリックすると、「条件設定」画面に遷移します。

8. 削除

   アイコンをクリックすると、登録済みの外部連携・アクション設定を削除します。

1. アイテム

   外部連携処理の対象のテーブル系アイテムの列の「列名」、「フィールド識別ID」を表示します。

2. イベントタイプ

   外部連携処理のタイミングとなる画面アイテムのイベントタイプを表示します。

   イベントタイプには以下の種類を選択できます。

   画面アイテムの種類によって使用できないものがあります。

   イベントタイプ	説明
   フォーカスイン	入力フィールドをマウスでクリックしたり、ユーザが［TAB］キーもしくは[Enter]キーを押してフォーカスを合わせたときに処理を実行します。
   クリック	入力フィールド、ボタン、アイコンをクリックしたとき、処理を実行します。
   入力	入力フィールドに値を入力してフォーカスが外れた時に処理を実行します。
   フォーカスアウト	他画面アイテムをマウスでクリックしたりユーザが［TAB］キーもしくは[Enter]キーを押してフォーカスが外れたときに処理を実行します。
   アイコンクリック	一覧選択の をクリックしたときに処理を実行します。
   インポート	ボタンをクリックしたとき、インポートを行います。
   エクスポート	ボタンをクリックしたとき、エクスポートを行います。

3. アクション

   設定しているアクションを表示します。

4. 説明

   アクション設定として設定した内容の説明を入力します。

   外部連携が設定済みの場合には、データソース定義名を表示します。

5. 前処理エラー時

   2件以上の外部連携を登録している場合に、直前に実行する外部連携・アクションがエラーの時に処理を続行する（次の処理を実行する）か、処理を中止するかを設定します。

   • 処理を続行する→直前の外部連携・アクションの結果に関係なく、処理を実行します。
   • 処理を中止する→直前の外部連携・アクションの結果がエラーとなった場合、処理を中止します。
   • スキップ→直前の外部連携・アクションの結果がエラーとなった場合、処理をスキップします。

6. 設定

   アイコンをクリックすると、選択されたアクションに応じて、以下の設定画面に遷移します。

   • 外部連携 → 「データマッパー」画面に遷移します。
   • 入力モード変換 → 「入力モード変換設定」画面に遷移します。
   • 表示モード変換 → 「表示モード変換設定」画面に遷移します。
   • カスタムスクリプト → 「カスタムスクリプト設定」画面に遷移します。

7. 条件

   アイコンをクリックすると、「条件設定」画面に遷移します。

8. 削除

   アイコンをクリックすると、登録済みの外部連携・アクション設定を削除します。

1. 入力フィールドを選択

   入力モードを切り替える対象の入力フィールドを選択します。

   選択した入力フィールドは、自動的に下の設定一覧に追加されます。

   コラム

   入力モード変換でテーブルと列を対象としたときの動作について

   入力モード変換で、テーブル全体を対象とする場合と、特定の列を対象とする場合には、以下のように動作が異なります。

   • テーブル全体を指定した場合
     • テーブルのすべての行が入力可、または入力不可になります。
     • 行の追加、削除についても、変換後の入力モードに応じて、追加・削除可能、または追加・削除不可になります。
   • テーブルの特定の列を指定した場合
     • テーブルの対象とした行のみが入力可、または入力不可になります。
     • 入力モード変換のイベント設定のアイテムが、対象と同じテーブル内の列以外のアイテムとなる場合、対象の列の全ての行を対象に、入力モードを変換します。
     • 入力モード変換のイベント設定のアイテムが、対象と同じテーブル内の列となる場合、イベントが発生した行の列のみを対象に、入力モードを変換します。

   注意

   • 「入力モード変換」は、画面を表示した時の表示タイプが「入力可」のアイテムに対して、入力可・不可を変換することができます。

     表示タイプが「参照」となっているアイテムに対しては、入力モード変換は実行できません。

   • 「入力モード変換」では、「ファイルアップロード」は対象外です。

2. 入力フィールド

   入力モード変換の対象となる入力系アイテム、もしくはテーブル系アイテムの列を表示します。

3. 入力モード

   イベント時に設定する入力モードを入力可、入力不可のいずれかから選択します。

4. 削除

   アイコンをクリックすると、登録済みの入力モード変換設定を削除します。

1. アイテムフィルタ

   画面アイテムを選択すると、選択された画面アイテムの種類で、下の対象アイテムリストを絞り込んで表示することができます。

2. 対象アイテムリスト

   表示モード変換の対象となる入力系アイテム、もしくはテーブル系アイテムの列を選択します。

   アイテムは、フォームでの配置で左上から右下の順で表示されます。

   選択したアイテムを選択後に、「追加」をクリックすると、下の設定一覧に追加されます。

   注意

   「表示モード変換」は、画面を表示した時の表示タイプが「非表示」 以外 のアイテムに対して、表示・非表示を変換することができます。

   表示タイプが「非表示」となっているアイテムに対しては、表示モード変換は実行できません。

3. 追加

   対象アイテムリストで選択したアイテムを選択後にクリックすると、下の設定一覧に追加します。

4. アイテム

   表示モード変換の対象となるアイテムを表示します。

5. 表示モード

   イベント時に設定する入力モードを表示、非表示のいずれかから選択します。

6. 位置調整

   アイテムの表示モードが変わったタイミングで、該当のアイテムより下に配置されているアイテムを移動するかどうかを設定します。

   チェックがオンの場合、アイテムを表示に変えると、アイテムの分下に移動させ、アイテムを非表示に変えると、その分上に移動させます。

   コラム

   位置調整の仕様

   「位置調整」は、以下の仕様で動作します。

   位置調整のチェックをオンにする場合には、以下の点を考慮した上で設定するようにしてください。

   • 位置調整は、表示モード変換の設定対象のアイテムの横幅内の下部に配置されているアイテムの表示位置を単純に移動します。

     

   • 複数のアイテムが横に並んでいる場合や重ねて配置している場合には、表示/非表示の変換後に想定している動作にならない場合があります。

   • 「位置調整」オプションは、シンプルなレイアウトのフォームで利用するようにしてください。

   • 特定の領域の複数のアイテムの表示モードを変換する場合には、1番左端に配置しているアイテムの「位置調整」をオンに設定し、他のアイテムは「位置調整」をオフに設定する、といった形で設定値を組み合わせて利用してください。

     

7. 削除

   アイコンをクリックすると、登録済みの表示モード変換設定を削除します。

1. スクリプト

   イベント設定で選択したアイテムイベント時に実行したい処理のスクリプトを記述します。

   スクリプトの処理の最後では、処理結果に応じて以下のエラーフラグを返却してください。

   エラーフラグは後続の処理を継続するか否かの判定にのみ使われます。

   • エラーの場合：true
   • 正常終了の場合：false

   コラム

   スクリプト内では　$(e.target)　でイベントのセレクタを取得することができます。

1. 条件

   イベント設定を実行するための条件を記述します。

   記述方法は、関数と同様の方法で、trueを返却する場合に、設定されたアクション・外部連携を実行します。

   • 記述例（以下は、フィールド識別ID「textbox1」に「みかん」と入力された場合に実行する例です。）

     textbox1="みかん"
     

   コラム

   数値や日付型項目に対する条件設定

   数値や日付のデータ型の項目に対して、条件を設定する場合には、以下のように記述します。

   • 数値型の場合

     【例】数値型のアイテム(フィールド識別ID：number1)の値が「5」の場合の条件の設定

     //パターン1
     
     number1-0=5
     
     //パターン2
     
     number1="5"
     

   • 日付型の場合

     【例】日付型のアイテム(フィールド識別ID：calendar1)の値が「2014年12月25日」の場合の条件の設定

     calendar1-0=datevalue("2014/12/25", "yyyy/MM/dd")
     

2. ヘルプ

   「 IM-BIS デザイナヘルプ 」の「関数」を表示します。

   条件を記述する場合には、ヘルプを参考に記述してください。