JavaScript アクション
JavaScript アクションを使用して、ランタイムにドキュメント オブジェクト モデル (DOM) にアクセスします。
フェデレーション セキュリティを使用してログオン フォームを作成すると、編集不可の JavaScript アクションがデフォルトで作成されます。フェデレーション セキュリティを参照してください。
-
フォーム モデリング バーで、[アクション] をクリックし、[新規] をクリックします。
[新しいアクション] ダイアログ ボックスが表示されます。
- [タイプ] リストで、[JavaScript] を選択します。
- デフォルトの [名前] (JavaScriptAction1) を意味のある名前に変更します。
- この項目は任意です。アクションの [説明] を入力します。
- この項目は任意です。[複数言語] を選択して、言語ごとに固有のアクションを個別に構成します。複数言語の設定アクションを参照してください。
-
JavaScript コードを入力するか、Java スクリプトを [スクリプト] ボックスに貼り付けて再利用します。また、次のような定義済みの関数を使用して、デスクトップ、モバイル、タブレット フォーム、およびすべてのキャプチャ フォームでフォーム変数、コントロール値、グローバル変数を取得/設定することもできます。同じページ アクションでサポートされているコントロールとプロパティは、JavaScript アクションでもサポートされています。
-
GetGlobalVariableValue(variableName)
-
GetFormVariableValue(variableName)
配列フォーム変数の取得/更新はサポートされていません。 -
GetControlValue(controlName)
-
UpdateGlobalVariableValue(variableName, value)
-
UpdateFormVariableValue(variableName, value)
-
UpdateControlValue(controlName, value)
スクリプトで無効な変数名やコントロール名などの無効なデータを指定すると、エラー メッセージが表示されます。
これらの関数を JavaScript アクションで使用するには、関数の前に必ず Forms.SDK を加える必要があります。次にいくつかの例を示します。
コントロール プロパティ
-
Forms.SDK.UpdateControlValue('textbox1.Label', 'test');
-
Forms.SDK.GetControlValue('textbox1.Label');
グローバル変数
-
Forms.SDK.GetGlobalVariableValue('CompanyCode');
-
Forms.SDK.UpdateGlobalVariableValue('CompanyCode', 'comp123');
フォーム変数
-
Forms.SDK.GetFormVariableValue('CustomerName');
-
Forms.SDK.UpdateFormVariableValue('CustomerName', 'TestName');
-
-
[追加] をクリックします。
新たに作成されたアクションがテーブルに追加されます。
-
このアクションをトリガーするため、アクションにコントロールを関連付けます。フォーム コントロール イベント用のアクションの構成を参照してください。または、フォーム イベントに対してこのアクションを呼び出すには、アクションをフォームに関連付けます。フォームへのアクションの関連付けを参照してください。
フォームの Onload イベントから JavaScript を使用してフォーム要素にアクセスすることはできません。
コントロールがアクションをトリガーすると、JavaScript が実行されます。スクリプトは DOM にアクセスでき、同じページで実行されます。