カスタマイズ

フィールド値入力ダイアログを表示してレコード追加する

概要

新規レコードを追加するためにフィールド値を入力するためのダイアログを表示し、ユーザーが入力した値でレコードを追加します。

使い方

「フィールド値入力ダイアログを表示してレコード追加する」を実行すると、まずフィールドの値を入力するダイアログが表示されます。複数のフィールド値を1つのダイアログで入力させることも可能です。

ユーザーに入力させるのではなく特定の値をセットしたいフィールドがある場合、そのフィールドの値は「入力しないフィールドのマッピング」で設定しておきます。

日付、時刻を入力する際は、所定の書式に従って入力する必要があります。書式エラーがある状態では、ダイアログのOKボタンを押すことができません。

  • 日付 … 2021-09-01 のように、年4桁、月2桁、日2桁をハイフン区切り。
  • 時刻 … 09:30 のように、時、分をそれぞれ2桁でコロン区切り。秒はなし。

ユーザーがダイアログ内でフィールド値を入力し、OKを押してダイアログを閉じると、レコード追加処理が実行されます。ダイアログでキャンセルした場合はレコード追加は行われません。

アクションはレコード追加が完了した時点で完了となります。「フィールド値入力ダイアログを表示してレコード追加する」をセットしたアクションを「確認・入力ダイアログで「OK」を押した時」でつなぐ際は注意が必要です。「確認・入力ダイアログで「OK」を押した時」はアクションが完了しないと発動しませんので、「OK」ボタンを押した瞬間ではなく「OK」を押した後にレコード追加が完了した時点で発動します。

「キャンセル」を押した場合はダイアログが閉じた時点でアクション完了になります。

設定するパラメーター

「メッセージ入力」「追加先アプリ」「入力するフィールド」「入力しないフィールドのマッピング」「OKボタンの名前」「キャンセルボタンの名前」「必須チェック」を設定します。

メッセージ入力

ダイアログのメッセージ部分に表示するテキストを入力します。

追加先アプリ

レコードを追加するアプリを選択します。

入力するフィールド

入力フィールドを指定します。

複数指定可能で、並び順も指定できます。複数でなく1つのフィールドだけ選択しても構いません。選択できるフィールド数に制限はありませんが、あまりに多くのフィールドを選択すると、ダイアログが画面からはみ出てしまいます。

以下のフィールドタイプが選択可能です。

  • 文字列(1行)
  • 数値
  • 日付
  • 時刻

テーブル内のフィールドは選択できません。

入力しないフィールドのマッピング

追加するレコードのフィールド値をマッピングします。

パラメーター名は「入力しないフィールドのマッピング」という名前ですが、「入力するフィールド」に含まれるフィールドに対してマッピングを設定しても構いません。その場合、入力ダイアログが表示される際の初期入力値がマッピングの値になります。

「入力するフィールド」に含まれないフィールドは、ここでマッピングした値で追加されます。

マッピングの記述方法はフィールドマッピングの記述方法を参照してください。

OKボタンの名前

OKボタンに表示するラベルを変更したい場合、このパラメーターを変更します。

キャンセルボタンの名前

キャンセルボタンに表示するラベルを変更したい場合、このパラメーターを変更します。

必須チェック

どのフィールドを必須にするかを選択します。

  • 「必須フィールドのみ入力を必須にする」
    • kintoneアプリのフォーム設定で必須に指定されているもののみ必須にします。
    • 必須フィールドの中に未入力があるとOKは押せません。必須でないフィールドは空でも、必須フィールドが全て入力されていればOKを押すことができます。
  • 「全てのフィールドで入力を必須にする」
    • すべてのフィールドが必須になります。kintoneのフォーム設定で必須でないフィールドも必須になります。
    • 未入力のフィールドがあるとOKは押せません。

Webhook 通知

追加先アプリに「レコードの追加」条件で Webhook 通知を行うように設定されている場合、本「やること」を実行するとこの通知が発生します。

注意事項

  • kintoneアプリのフォーム設定で「フィールド名を表示しない」をオンにしていても、「フィールド値入力ダイアログを表示する」のダイアログではフィールド名が表示されます。

制限事項

  • スマートフォン版画面では、日付フィールドの手入力には対応していません。カレンダーからの選択のみ対応しています。

  • すでにほかのダイアログが開いていて、ユーザーがそのダイアログをまだ閉じていない状態の時に「フィールド値入力ダイアログを表示してレコード追加する」を実行した場合、すでに開いているダイアログの方が優先され、後から実行した「フィールド値入力ダイアログを表示してレコード追加する」は無視されます。この場合、「フィールド値入力ダイアログを表示してレコード追加する」の結果はキャンセル扱いになります。