シートから読み取り処理
オペレーション名
シートから読み取り
機能概要
Excelデータをシート単位で読み取ります。
データモデル
本コンポーネントのデータモデルはテーブルモデル型です。
プロパティ
変数の使用については、「変数」を参照してください。
基本設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
名前 |
必須 |
使用不可 |
スクリプトキャンバス上での名前を入力します。 |
|
必須設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
ファイル |
必須 |
使用可 |
Excelファイルのファイルパスを入力します。
|
注意
|
|
シート名 |
省略可 |
使用可 |
[ファイル]で指定したExcelファイルのシートを選択または入力します。 |
|
|
列一覧 |
省略可 |
- |
列を指定します。 列一覧の各列は以下のボタンで操作することができます。
|
|
|
列一覧/列名 |
必須 |
使用可 |
列名を入力します。 |
|
|
列一覧/型 |
必須 |
使用不可 |
[列名]の型を選択します。
|
|
プロパティアクション
|
項目名 |
説明 |
備考 |
|---|---|---|
|
Excelウィザードの起動 |
[ファイル]で指定したファイルをExcelウィザードで起動します。 = 備考 =
設定方法については、「Excel読み取りウィザード」を参照してください。 |
|
|
列一覧の更新 |
[ファイル]で指定したファイルの1行目の値から列名と型を取得して、[列一覧]に設定します。 |
注意
対象のセルの値が空の場合、そのセルと異なる型が[列一覧/型]に設定されることがあります。 |
開始/終了条件
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
読み取り開始条件を指定 |
省略可 |
使用不可 |
読み取り開始条件を指定するかどうかを選択します。
|
|
|
開始条件 |
省略可 |
使用不可 |
読み取り開始条件を選択します。
|
|
|
マッチ文字列 |
省略可 |
使用可 |
読み取り開始条件のマッチ文字列を入力します。 |
|
|
セルアドレス |
省略可 |
使用可 |
読み取り開始条件のセルアドレスを入力します。 例:A1 |
|
|
読み取り終了条件を指定 |
省略可 |
使用不可 |
読み取り終了条件を指定するかどうかを選択します。
|
|
|
終了条件 |
省略可 |
- |
読み取り終了条件を指定します。 各列は以下のボタンで操作することができます。
|
|
|
終了条件/列名 |
必須 |
使用不可 |
読み取り終了条件のチェックを行う対象の[列名]を選択します。 |
|
|
終了条件/行番号 |
省略可 |
使用可 |
読み取り終了条件のチェックを行う対象の行番号を入力します。 [(指定しない)]を選択した場合、全行を対象に読み取り終了条件のチェックを行います。 |
|
|
終了条件/条件値 |
省略可 |
使用可 |
読み取り終了条件の条件値を入力します。 [(指定しない)]を選択した場合、セルの値に関わらず[行番号]の行が読み取り終了行となります。 |
|
|
終了条件/論理演算子 |
必須 |
使用不可 |
[条件値]の論理演算子を選択します。
|
|
読み取り設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
最初の行は値として取得しない |
省略可 |
使用不可 |
指定したファイルの1行目をデータとして扱うかどうかを選択します。
|
|
|
セルの数式を読み取る |
省略可 |
使用不可 |
セルの数式をデータとして読み取るかどうかを選択します。
|
注意
[ファイル]にExcelブックを指定した場合、無効になります。 |
データ処理方式
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
データ処理方式 |
必須 |
使用不可 |
データ処理方式を選択します。
|
コメント
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
コメント |
省略可 |
使用不可 |
このコネクターの簡単な説明を記述することができます。 |
|
スキーマ
入力スキーマ
ありません。
使用できるコンポーネント変数
|
コンポーネント変数名 |
説明 |
備考 |
|---|---|---|
|
count |
読み取ったデータの件数が格納されます。 |
注意
PSPでは値が格納されません。 |
|
filePath |
ファイルのパスが格納されます。 |
注意
PSPでは値が格納されません。 |
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
|
error_type |
エラー発生時、発生したエラーの種類が格納されます。 |
|
|
error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
|
|
error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
|
-
[論理演算子]に複数の[OR]を指定した場合、以下の行が読み取り終了行となります。
-
いずれかの条件にマッチした行
-
-
[論理演算子]に複数の[AND]を指定した場合、以下の行が読み取り終了行となります。
-
[行番号]にすべて[(指定しない)]を選択した場合、同一行ですべての条件にマッチした最初の行
-
[行番号]に行番号を指定した場合、すべての条件にマッチした最終行
例:
読み取り対象ファイル
行番号
列1
列2
列3
列4
1
AAA
BBB
CCC
DDD
2
EEE
FFF
GGG
HHH
3
III
JJJ
KKK
LLL
4
AAA
BBB
CCC
DDD
5
EEE
FFF
GGG
HHH
6
III
JJJ
KKK
LLL
読み取り終了条件(行番号を指定しない場合)
列名
行番号
条件値
論理演算子
列1
[(指定しない)]
EEE
[AND]
列2
[(指定しない)]
FFF
[AND]
読み取り終了行は2行目となり、1行目のみ読み取られます。
読み取り終了条件(行番号・条件値を指定した場合)
列名
行番号
条件値
論理演算子
列1
2
EEE
[AND]
列2
5
FFF
[AND]
読み取り終了行は5行目となり、4行目まで読み取られます。
読み取り終了条件(行番号を指定し、条件値を指定しない場合)
列名
行番号
条件値
論理演算子
列1
2
[(指定しない)]
[AND]
列2
7
[(指定しない)]
[AND]
読み取り終了行は7行目となり、6行目まで読み取られます。
読み取り終了条件(行番号を指定した条件と指定しない条件が混在する場合)
列名
行番号
条件値
論理演算子
列1
4
[(指定しない)]
[AND]
列2
[(指定しない)]
FFF
[AND]
-
-
読み取り終了行は5行目となり、4行目まで読み取られます。
-
[行番号]と[条件値]の両方に[(指定しない)]を選択した場合、1行も読み取られず処理が終了します。
-
Excel 2003ブックで、終了条件に指定した列以降に値および書式が1つも設定されてない場合、当該終了条件にはマッチしません。
nullと空文字について
-
読み取り対象のセルの値が空文字の場合、読み取ったデータはnullとなります。
メッセージコード、例外メッセージ、制限事項
|
コネクター |
メッセージコード |
例外メッセージ |
制限事項 |
|---|---|---|---|
|
|
|
|
