一度に複数の連番を取得し、それを指定されたレコードのフィールドにセットします。
アクションが実行されると gusuku のサーバーに通信を行い、取得した値を指定されたレコード内のフィールドにセットします。
通常の「自動採番を行う」の場合、１回のアクションで１つの採番を行うので、複数アクションを実行して連続して採番しようとしても、他の採番処理に割り込まれると番号が飛んでしまう可能性があります。それに対し、「複数のレコードに対して一度に自動採番を行う」では必ず連続した番号を採取できます。
通信が発生しますので、通信環境によっては値がセットされるまで少し時間がかかる場合があります。通信中は「採番中…」と表示され、入力ができない状態になります。
「複数のレコードに対して一度に自動採番を行う」ではアクション自身でレコードを保存することはありません。必要であれば「レコードを書き出す」等でレコードを保存するアクションを設定してください。逆に、krewSheet のレコード保存時に「krewSheetで保存しようとしているレコードを取得する」で取得したレコードに対して採番する場合は、そのまま krewSheet がレコード保存しますので、アクションでレコードを書き出す必要はありません。
「レコード」「フィールド」および採番ルールを決めるパラメーターを設定します。
採番した値をセットする先のレコードを選択します。
採番した値をセットする先のフィールドを選択します。
フィールドの値は、ゼロ埋めなどのフォーマットされた状態でセットされます。
選択できるフィールドタイプは以下の通りです。
数値を選んだ場合、プレフィックスやサフィックスをつけると、アクション実行時にエラーになります。
指定した「レコード」の指定した「フィールド」に、すでに値が入っている場合の扱いを選択します。
「上書きする」の場合は値が入っていても、採番した値で上書きします。
「元の値を維持する」の場合は、上書きせずに元のフィールド値のまま維持されます。この場合、値が入っている行は採番の対象になりません。例えばレコードが全体で５行あり、うち２行ですでに値が入っている場合、採番される値は３つになり、この３つが連番になります。すでに入っている行の分が欠番になることはありません。
「なし」を選んだ場合、採番される番号はドメイン全体での連番になります。
「アプリ単位で採番」を選ぶと、連番はアプリ毎に管理されます。
ゼロ埋めする場合、次の桁数で指定した桁数に満たない場合にゼロ埋めされます。
ゼロ埋め「する」の場合、桁数は必ず１以上の値を設定してください。
例えばゼロ埋め「する」で桁数「8」の場合、採取した番号が「1」だったら、フィールドに「00000001」という値がセットされます。
ゼロ埋めする場合の最大桁数を指定します。ゼロ埋めしない場合はこのパラメーターは無視されます。
採取した番号がこの桁数を超えた場合、桁数のカットは行われません。 例えば桁数「3」で「1234」という番号が採取された場合、「123」や「234」にカットされるのではなく、「1234」という値がそのままセットされます。
採取した番号の手前に固定文字列を付けたい場合に指定します。
採取した番号の後ろに固定文字列を付けたい場合に指定します。
「なし」を選ぶと番号がリセットされることはありません。
「月単位で採番」を選ぶと、翌月には連番が１にリセットされます。
「年単位で採番」を選ぶと、年初の１月１日に連番が１にリセットされます。
「年度(4月開始)単位で採番」を選ぶと、４月１日に連番が１にリセットされます。
採番サイクルで月単位や年単位を選んだ場合、どの国・地域の時刻を基準にするかを選択します。
独自に採番キーを設定したい場合にこのパラメーターをセットします。省略可能です。
複数のアクションで「自動採番を行う」場合、「採番キー」省略時は「フィールド」で指定したフィールドコードが同じものが同じ採番グループとして通し番号が発行されます。「採番キー」を指定すると、フィールドではなく、同じ「採番キー」を指定したものが同じ採番グループになり、その中での通し番号が発行されます。
自動採番がどの範囲で連続性をもつのかどうかは「フィールド」「アプリ単位の採番」「採番キー」の組み合わせによって変わります。以下の表を参考にしてください。
| フィールド | アプリ単位の採番 | 採番キー | 採番の範囲 |
|---|---|---|---|
| 指定なし | なし | 指定なし | 同一アクション番号 |
| 指定なし | なし | 指定あり | 同一採番キー |
| 指定なし | アプリ単位で採番 | 指定なし | アプリ内の同一アクション番号 |
| 指定なし | アプリ単位で採番 | 指定あり | アプリ内の同一採番キー |
| 指定あり | なし | 指定なし | 同一フィールドコード |
| 指定あり | なし | 指定あり | 同一採番キー |
| 指定あり | アプリ単位で採番 | 指定なし | アプリ内の同一フィールド |
| 指定あり | アプリ単位で採番 | 指定あり | アプリ内の同一採番キー |
特に、この３つのパラメーターを全て省略した場合、kintoneサブドメイン全体での広い範囲の連番になるのではなく、逆にそのアクションのみの狭い範囲の連番になる点に注意してください。アプリを横断してkintoneサブドメイン全体での連番を行いたい場合は「アプリ単位の採番」を「なし」にして「採番キー」を指定してください。