アドオンの申請番号や管理番号を重複なく採番したいときは、SAPの番号範囲オブジェクトを利用できます。SNROで番号範囲を定義し、ABAPからNUMBER_GET_NEXTで次の番号を取得するのが基本です。単に現在番号に1を足す実装では、同時実行時の重複や運用時の採番管理が難しくなります。
SNROとNUMBER_GET_NEXTの役割
| 要素 | 役割 |
|---|---|
| 番号範囲オブジェクト | 何の番号を採番するか、番号の長さや年・サブオブジェクトなどの区分を定義する |
| 番号範囲間隔 | 01などの間隔番号、開始値・終了値、内部/外部採番を設定する |
NUMBER_GET_NEXT | 指定したオブジェクトと間隔から、内部採番の次の番号を取得する |
標準伝票の採番はその業務機能が管理します。ここでの例はアドオン独自の番号が必要な場合です。標準伝票番号をこの汎用モジュールで独自に上書きする設計とは分けて考えます。
設定から利用までの流れ
SNROで独自の番号範囲オブジェクトを登録し、番号長、年依存・サブオブジェクト依存、バッファの要否を決める。- 対象クライアントで内部採番の間隔を用意し、番号の上限や他の用途との重複を確認する。
- ABAPから
NUMBER_GET_NEXTを呼び、オブジェクト名と間隔番号を指定する。年依存などの設定がある場合は、対応する引数も渡す。 - 取得できた番号を業務データのキーに保存する。汎用モジュールの例外と、保存処理の失敗をそれぞれ確認する。
引数名と例外はSE37で対象システムのインターフェースを確認してください。間隔番号の「01」と「1」は同じと決めつけず、設定値に合わせます。番号を取得しただけでは業務レコードの保存完了を意味しません。
番号の欠番とバッファに注意
採番後に保存が失敗した場合や、番号範囲をバッファリングした場合など、連番に欠番が生じることがあります。バッファは性能上の利点がある一方、厳密な連続番号を要する法定帳票などには適用可否の確認が必要です。番号が重複しないことと、番号に欠番がないことは別の要件です。
番号の枯渇、複数アプリケーションサーバーからの同時実行、再実行時の二重登録、年切替時の間隔をテストします。番号範囲の現在値を直接更新して調整する運用は避け、設定と業務データを合わせて管理してください。
よくあるエラーの切り分け
- 間隔が見つからない:オブジェクト、間隔番号、クライアント、年・サブオブジェクトの組合せを確認する。
- 番号が上限に達した:間隔の残数と業務上必要な番号長を確認する。
- 番号は取得したがデータがない:後続の登録処理とコミット、エラーメッセージを確認する。
参考・関連記事
- 汎用モジュール一覧:アドオン開発で使う機能を探す
- バグの少ないプログラムを書くためのABAPの基本:例外と再実行を含む実装の考え方
- SAPの標準テーブル一覧:番号範囲関連のテーブルを調べる入口