本記事は、%Library.PopulateUtils.clsの備忘録になります。
関数説明 %PopulateUtilsに設定された関数群の説明と使い方の解説を行います。
Integer・String等の基本的な型 Integer 整数値を返す
・引数
w ##class(%PopulateUtils).Integer() // 126453899
Float 浮動小数点値を返す
・引数
scaleは小数点以下の桁数
w ##class(%PopulateUtils).Float(0,100,4) // 37.8325
String 文字列を返す
・String(len As %Integer = 1) as %String
パターンは下記
1～5文字内で、len桁で切り取って返す。
w ##class(%PopulateUtils).String(5) // R8008
StringMin 文字列を返す
・引数
w ##class(%PopulateUtils).StringMin(1,10) // hQkNPac
VarString 文字列を返す
・引数
返される文字列は、最大「maxlen」内のランダムな文字数になる
w ##class(%PopulateUtils).VarString(10) // RRZ!%[RZ7
日時関連 Date 日付を返す
・引数
w ##class(%PopulateUtils).Date() // 39581
CDate 日付を指定のフォーマットで出力します。
・引数
// 2024-01-01～2024-12-31間の日付をyyyy-mm-ddのフォーマットで返す
w ##class(%PopulateUtils).CDate(3, 66840, 67205)
PosixTime PosixTime値を返す
PosixTime(min As %PosixTime = “”, max As %PosixTime = “”) as %PosixTime
min, maxが有効値でない場合、min=-6919738016441081856 (1900-01-01 00:00:00)、max＝現在日時
w ##class(%PopulateUtils).PosixTime() // 1154312571753350586
TimeStamp タイムスタンプ値を返す
・引数
w ##class(%PopulateUtils).TimeStamp() // 1987-06-15 01:10:46
住所関連 USState アメリカの州の略語を返す
AK, AL, AR, AZ, CA, CO, CT, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WI, WV, WY
w ##class(%PopulateUtils).USState() // ND
City 26の都市名を返す。
都市名のリストは下記。頭文字がA～Zまでの都市名。KがなくBが重複している。A lbany, B oston, B ensonhurst, C hicago, D enver, E lmhurst, F argo, G ansevoort, H ialeah, I slip, J ackson, L archmont, M iami, N ewton, O ak C reek, P ueblo, Q ueensbury, R eston, S t Louis, T ampa, U kiah, V ail, W ashington, X avier, Y oungstown, Z anesville
w ##class(%PopulateUtils).City()
Street 住所を返す
パターンは下記
【第①グループ】
【第②グループ】
w ##class(%PopulateUtils).Street() // 8191 Washington Court
USZip アメリカの郵便番号を返す
パターンは下記
w ##class(%PopulateUtils).USZip() // 14938
USPhone アメリカの電話番号を返す
パターンは下記
w ##class(%PopulateUtils).USPhone() // 588-795-7227
人物情報 FirstName 人物の名前を返す。男と女を引数に持つ。
・引数
【男性名称=75種】
【女性名称=74種】
w ##class(%PopulateUtils).FirstName()
LastName 人物の苗字を返します。すごい多い・・・
【苗字245種】
w ##class(%PopulateUtils).LastName()
Name 人名を返す
組み合わせは下記ルール。ファーストネームからじゃないのか・・・
・引数
w ##class(%PopulateUtils).Name() // Thompson,Charlotte G.
SSN 米国社会保障番号を返す
パターンは下記
w ##class(%PopulateUtils).SSN() // 822-21-8024
会社情報 Company 会社名を返す
会社名生成のルールは下記３つのグループを①_②_③の順に結合して返す
【第①グループ】
【第②グループ】
【第③グループ】
w ##class(%PopulateUtils).Company()
Mission 「企業の目指す目標・使命・経営理念」等を返す
下記6つのグループから１つづつ選択し、順に結合して返す。
【第①グループ】
【第②グループ】
【第③グループ】
【第④グループ】
【第⑤グループ】
【第⑥グループ】
w ##class(%PopulateUtils).Mission()
Title 役職を返す
下記２つのグループを連結する
【第①グループ】
【第②グループ】
w ##class(%PopulateUtils).Title() // Global Director
Product 製品名を返す
Table, Chair, Lamp, Desk
w ##class(%PopulateUtils).Product()
その他 ArrayElement 引数「text」に渡す配列から、ランダムで１つを選択し返します。
k text
s text($i(text))="a"
s text($i(text))="b"
s text($i(text))="c"
w ##class(%PopulateUtils).ArrayElement(.text) // 値がランダムで返る
BuildReferenceSample 指定したテーブルのレコードIDを取得します。
・引数
クラスのレコードIDが第二引数「sample」に格納されます。
s clsNm="developer.csv.Patient"
d ##class(%PopulateUtils).BuildReferenceSample(clsNm,.sample, 10, 90)
zw sample
// 下記がターミナルに表示されます
// sample=10
// sample(1)=51
// ...
// sample(10)=20
BuildValueSetSQL SQLを実行し、列データを取得します。
・引数
下記グローバルに格納されます。
verbose=1とすると、実行クエリや進行状況などが出力されます。
s tbl="developer_csv.Patient"
s clm="漢字氏名"
d ##class(%PopulateUtils).BuildValueSetSQL(1,1,tbl,clm,10,1)
zw ^IRIS.Temp(1,1)
// 下記がターミナルに表示されます
// ^IRIS.Temp(1,1)=10
// ^IRIS.Temp(1,1,1)="伊藤 太郎"
// ...
// ^IRIS.Temp(1,1,2)="佐藤 太郎"
ExtentValue ^IRIS.Temp(cptr, cext)のデータをランダムに返す
・引数
w ##class(%PopulateUtils).ExtentValue(1,1) // 田中 太郎
Counter ^||%Populate(“c”, counter)に対し、$incrementを実行します。
・引数
counter=カウントする種類、initial=初期値
w ##class(%PopulateUtils).Counter("a") // 1
w ##class(%PopulateUtils).Counter("a") // 2
w ##class(%PopulateUtils).Counter("b", 2) // 2
w ##class(%PopulateUtils).Counter("b") // 3
Currency 通貨値を返す
・引数
w ##class(%PopulateUtils).Currency() // 7433.543 小数点...?
Color 5つの色名を返す
Red, Green, Blue, Yellow, Black
w ##class(%PopulateUtils).Color()
Random 0～nの乱数を返す
w ##class(%PopulateUtils).Random(100) // 28
Syllable 意味ありそうで全くない文章っぽいような文字列を返す。
・引数
下記４つのグループからランダムに文字列を選択し結合し、maxlenの値で切り落とす。
【第①グループ】
【第②グループ】
【第③グループ】
【第④グループ】
w ##class(%PopulateUtils).Syllable() // LyCom TechCoOn Invent IcL
ValueList 指定したリストから文字を返す
w ##class(%PopulateUtils).ValueList(",藤原道長,紫式部,源倫子,一条天皇") // 源倫子
おわりに 今回、本記事を書くにあたり、%PopulateUtilsの各関数を覗いてみました。
「意味のあるテストデータを作成して使ってほしい。」
皆様も、何かの折にこのクラスをみかけたら、覗いてみてください。
ただし英語だけどね！(笑
