GlideRecord実務スニペット集：検索・集計・更新をコピペで

この記事は、開発ハンズオンシリーズの8回目です。①のGlideRecordから⑦まで続けてきました。Scripts - Background でコードを1本ずつ動かしながら、検索・集計・参照・日付・gs をたどってきた道のりです。今回は、その道中で実機検証したコードを、用途別にコピペで使える形にまとめた保存版をお届けします。

「あの書き方、どの回だっけ」と探し回る手間をなくすのが狙いです。1件だけ取りたい、条件で絞って回したい、件数を数えたい、参照先の名前を出したい。そういう「やりたいこと」から逆に引けるよう、レシピを並べました。見出しを目次のように使って、必要なところだけ拾ってください。

載せているコードは、すべて筆者の PDI（Zurich・OOTB）の Scripts - Background で実際に流し、件数や値は REST でも読み直して突き合わせています。貼って動かせば、記事と同じ結果がほぼそのまま出るはずです。数字はインスタンスによって前後しますが、書き方そのものは変わりません。安心して手元にコピーしてください。

今回そろえたレシピは、大きく次の6つの用途に分かれます。

• 検索・取得 … 1件を番号で取る、条件で複数を回す、画面フィルタの文字列で取る

• 集計 … 総件数、優先度ごと、状態ごとの件数を GlideAggregate で数える

• 更新 … 練習用のレコードを安全に書き換える

• 参照 … ドット・ウォークで参照先の名前やメールを読む

• 日付 … GlideDateTime で経過時間を出す

• gs … システム設定値の取得と空判定

ひとつだけ約束事があります。どのレシピも、必ず PDI（自分専用の無料の検証インスタンス）で試してください。会社の本番インスタンスでは、絶対に動かさない。とくに後半の更新系は、実際にデータへ書き込みます。練習は使い捨てのレコードで、というのを最後まで守っていただけると安心です。

全体像を1枚にした早見表を、先に置いておきます。どのレシピがどのメソッドを使うのか、ここでざっと見渡せます。目次代わりに眺めてから、気になったところへ飛んでください。

ここから先は、そのままコピーして動くコードを、実測の結果つきで並べます。1つのレシピにつき「何のためか」「コード」「出たらこうなる」の3点をセットにしました。上から順に読んでも、目次から必要なところへ飛んでも構いません。