READ コマンドは、指定のワークシートのセル範囲を作業リストに読み込む場合に使用されます。各セル値の末尾のブランクは切り詰められます。
必須
READ
任意
>-- SHEET ----------- 値---------------------->
>-- R1C1 ------------ n,n ------------------------>
>-- ROWCOUNT -------- 値 ---------------------->
>-- IGNORE --------- *NONE ----------------------->
*EMPTY
>-- SCALE ---------- 値 ----------------------->
>-- NUMBERFORMAT --- *NONE ----------------------->
*DEFAULT
*CLIENT
*USERAGENT
値
>-- ROW ------------ 値 -----------------------|
キーワード
|
SHEET |
特定のシート名を入力できます。シート名を入力しない場合は、現在のコンテキスト・シートが使用されます。 |
|
R1C1 |
開始行と列のデフォルトを 1, 1 に設定します。これは行と列の読み込みの開始位置を示します。 |
|
ROWCOUNT |
読み込む行数を指定します。キーワード ROWCOUNT が使用されない場合、シートの最後までのすべての行が読み込まれます。 |
|
IGNORE |
デフォルト値*NONEの場合、すべてのエントリーが処理されます。代替オプション*EMPTYの場合、空のエントリーは無視されます。 空のエントリーとは、リスト・エントリーを構成するすべてのセル値が空の文字列値の場合です。 |
|
SCALE |
このオプションのキーワードは、一般的な数字形式の数値セルで使用される10進法を指定します。デフォルト値は 4です。 |
|
NUMBERFORMAT |
このオプションのキーワードは、小数区切り文字が小数点文字「.」ではない数字文字列を処理します。 詳細は、「NUMBERFORMAT 」を参照してください。 |
|
ROW |
この任意のキーワードは R1C1 と ROWCOUNT の代わりに使用することができます。 指定の行番号のみが読み込まれ、行内のすべての列は単一のフィールド作業リストのエントリーとして戻されます。 |
例
RDML
USE BUILTIN(JSM_COMMAND) WITH_ARGS('READ SHEET(PARTS) SERVICE_LIST(LINENUM,PARTNUM,PARTDSC,PARTAMT,PARTQTY)') TO_GET(#JSMSTS #JSMMSG #ORDLIST)
または
USE BUILTIN(JSM_COMMAND) WITH_ARGS('READ SHEET(PARTS) R1C1(10,3) SERVICE_LIST(LINENUM,PARTNUM,PARTDSC,PARTAMT,PARTQTY)') TO_GET(#JSMSTS #JSMMSG #ORDLIST)
RDMLX
use builtin(jsmx_command) with_args(#jsmhandle 'read sheet(parts)') to_get(#jsmsts #jsmmsg #ordlist)
または
use builtin(jsmx_command) with_args(#jsmhandle 'read sheet(parts) r1c1(10,3)') to_get(#jsmsts #jsmmsg #ordlist)