More than 3 years have passed since last update.

CDS オートナンバー列（任意のID生成方法もあるよ！）

Posted at 2020-11-02

「オートナンバー」あるいは「自動採番（付番）」の列をご存じでしょうか？

該当テーブルにデータを登録するたびに、番号が「1、2、3・・・」のように自動的にふられていく仕組みのコトです。これを利用すると重複しない連番が得られます。重複しないので、プライマリーキー（主キー＝データを一意に判別するための要素）として利用するなどのメリットを享受することが可能になります。SQL Server 経験者の方であれば、テーブル列における自動採番する「IDENTITY」をイメージされているコトでしょう。

さて、Power Apps の文脈でデータソースと言えば CDS ですよね。勿論 CDS にもオートナンバーの仕組みは提供されています。

公式情報

関連する Docs を下記にしておきます。

CDS のオートナンバー列は優秀で便利

例えば、SQL Server の「IDENTITY」列は「1、2、3・・・」というように、数字が増えていくだけです。CDS は単純な数値以外の要素もオートナンバー列に指定ができます。

例えば「西暦4桁＋月2桁＋”-"（ハイフン）＋3桁でゼロパディング（ゼロ詰め）された連番」といった列を、列の設定だけで実現できるんですよ。勿論、末尾の連番はデータ登録されるたびに増加（インクリメント）されます。

　例： 202001-001

なお、この特性は、PowerApps for Teams = Project Oakdale の CDS も同じです。これ、凄く便利ですよね！

CDS のオートナンバー列

「CDS Project Oakdale」（通称 ”おーくでーるCDS” ※中のヒトが勝手に呼称してるだけ）を利用して、実際の設定をメモしておきます。なお、記事投稿時点では、CDS（無印）と「CDS Project Oakdale」（通称 ”おーくでーるCDS”）の設定方法は同様です。

以降、「おーくでーるCDS」を利用した画面ショットになります。同じ画面に辿り着きたい方は「CDS #ProjectOakdale の裏技？ #PowerApps」を事前にご確認ください。

1．オートナンバー列を追加する画面

テーブル（エンティティ）へ列を追加する際は、左上にある「列の追加」をクリックします。

右側から”にゅるん”と列の追加設定画面が表示されるので、必要な項目を設定していきます。

［データ型］の横目で”オートナンバー”を選択することで、自動採番が実現できます。
［最小桁数］は、その名の通り連番の桁数（最小）になります。
［シード値］は、連番の開始番号です。デフォルト 1000 なので、1から開始したい場合はここを修正します。
［プレビュー］で上記の設定結果が”実際にどうなるか？”が確認可能です。

例えば、最小桁数3、シード値が10だった場合、1つ目のデータを登録すると”010”という値が自動的に設定されます。所謂、ゼロ詰め（ゼロパディング）された ID 情報みたいなモノがこの設定のみで実現可能なことが伝わっているでしょうか。

なお、プレビューは設定を変更した場合は必ずチェックするコトをオススメします。ケアレスミスが激減すると思います。こういう細かい便利ポイント、個人的に大好きです。

2．CDS オートナンバーの種類

CDS（おーくでーるCDS）には3種類の設定方法が提供されています。

2-1．文字列が先頭に付加される数

「固定文字列」＋「連番」が作成可能です。
これはイメージしやすいと思います。

2-2．日付が先頭に付加される数

「日付」＋「連番」が作成可能です。

一見便利そうですが、日本語環境での利用は注意点があります。

上の画面ショットを取得したのは 2020年11月2日です。画像を確認すると把握できると思いますが”年月日”（＝yyyyMMdd）のような日本人に’なじみのある形式’が選択肢にありません。所謂”海外の表記”になっています。加えて、クラウド上のデータなので世界標準時（UTC）になります。

2-3．カスタム

固定文字列や日付などを利用して任意の形式を作成可能です。
”年月日”などを実現したい場合はコレを利用します。

例えば「年月日＋連番4桁」を指定したい場合。

月次でデータを判別したい場合などに便利な「年月＋連番3桁」のような指定も可能です。

その他、指定可能なオプションは下記Docsを参照ください。

AutoNumberFormatオプション

実は、Docs に書かれているようなオプションを覚える必要はなくて、列の追加画面である程度のコトは完結できてしまいます。［形式］のすぐ下にある選択肢を変更すると、シーケンス番号（連番）や日時、ランダム文字列を表すオプションが自動的に挿入される仕組みになっています。

これを利用して、日時を追加 → 年月（yyyyMM）に変更する、という手順が簡単に実施可能です。しかも、紹介済みの[プレビュー]で得られる効果がスグに把握可能なので間違いにも気づきやすいです。ほんと、便利。