setSubmitMode (クライアント API 参照)
レコードの保存時に列からデータを送信するかどうかを設定します。
対応している列の種類
すべて
構文
formContext.getAttribute(arg).setSubmitMode(mode)
パラメーター
種類: 文字列。
説明: 次のいずれかのモードの値を設定します。
always
: データは保存時に常に送信されます。never
: データは保存時に送信されません。 この値を使用すると、この列のフォームの列は編集できません。dirty
既定の動作。 データの変更時に保存されて送信されます。
備考
このメソッドを使用して、レコードが作成または保存されるときに列のデータを送信するタイミングを制御します。 たとえば、フォームのロジックを制御することだけを目的とした列がフォームにある場合があります。 内部データの取得は考慮しません。 データが保存されないように設定するとします。 または、常に含まれている値に応じて、プラグインを持つ場合もあります。 常に含まれるように列が設定できます。
注意
列の送信モードが never
に設定されている場合でも、列のデータは保存操作後に常に更新されます。 たとえば、サーバーの列の値が null で、列の送信モードが never
に設定され、列がユーザーによって何らかの値で変更される場合は、ユーザーがフォームを保存した後に列の値は null に置き換えられます。
createdby
など、レコードの初回保存後に更新されない列は、保存時に送信されないように設定されます。 変更されているかどうかに関係なく、列の値を強制的に送信するには、mode
パラメーターを always
に設定し、このメソッドを使用します。
関連記事
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。