ヘルプには関数の説明は載っているけれど、前提条件が必要だよね、と思ったので記録。
GetNextSerialValueとは
GetNextSerialValueは、フィールドに設定されているシリアル番号の次の値を取得します。
解説では、「ファイル名のフィールド名の次のシリアル番号を返します。」と載っていますが、これでは実は不十分ですぐに使えません。
シリアル番号は、その名の通りシリアル（連続的）な値になります。
1ずつ増加する場合は1,2,3,4,5,,,となり、3ずつ増加する場合は1,4,7,10,,,と続いていきます。
食べるシリアルではありません。（食べたら増えずに減ります）
何が足りないのか
足りないのは、フィールドのシリアル番号設定です。
このシリアル番号のチェックをつけていない場合、新規レコードを作ってもスクリプトでGetNextSerialValueを使ってもシリアル番号は自動で設定されません。
ではどうすれば使えるのか
GetNextSerialValueを使いたい場合は、こんな↓感じで先に設定します。
この場合は、新規レコードを作成した際に自動的に番号が2に設定されます。
増分が1となっているので、次にくる番号は2です。
仮に増分が2になっている場合、「次の値」2を採番した次に来る番号は4です。
数字しか指定できないの？
数字だけではなく、実は文字列も指定できます。
この例では、"item"という文字列を接頭辞として、4桁の数字の連番にしたい、という意図になります。
順々にレコードを増やしていくと、こんな↓感じで連番が自動で割り振られます。
スクリプトはどうなるの？
先ほどと同じような感じで"item"接頭辞＋５桁の数字の連番をスクリプトで実装する場合は、↓のようなシリアル番号の設定をしておき、
↓のようなスクリプトを用意します。
違いがわからない。。。
シリアル番号の設定していない時にスクリプトを実行すると、下の図の(1)のように連番がつきません。
また、単純にFileMakerの「＋」ボタンでぽんぽんレコードを増やしていっても連番も何もない状態でレコードが出来上がります。(2)
フィールドのオプション設定だけやってればいんじゃない？
と思うところですが、使い道として接頭辞を場面ごとに切り替えたい場合などに便利です。
例えば、レストラン、カフェ、ファストフードというようなカテゴリを接頭辞として番号を作りたい場合は、実行するスクリプトに引数でカテゴリを指定して連番を作成できます。
今回はレイアウトに配置したそれぞれのボタンのスクリプトの引数に接頭辞を指定します。
ボタンをそれぞれ押していくと、連番で商品番号が作成されます。
もっと高度なことはできるの？
GetNextSerialValueは、フィールド設定の「シリアル番号」設定を元に、単純にフィールドに指定された次の値と増分を指定して連番を作成する仕組みを提供しています。
単純に連番が作れるのであれば、これだけで十分ですが、例えばカテゴリごとに連番を作りたい場合はGetNextSerialValueではなく別な手段も使えます。
そんな記事も書いていますので、シリアル番号を振るのに物足りなくなったら参考にしてみてください。
【FileMaker】カテゴリごとに管理番号を振る （追記あり）