シートから読み取り処理
オペレーション名
シートから読み取り
機能概要
Googleドライブ上のスプレッドシートのデータをシート単位で読み取ります。
データモデル
本コンポーネントのデータモデルはテーブルモデル型です。
プロパティ
変数の使用については、「変数」を参照してください。
基本設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
名前 |
必須 |
使用不可 |
スクリプトキャンバス上での名前を入力します。 |
|
必須設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
接続先 |
必須 |
使用不可 |
コネクションリソースを選択します。
|
|
|
フォルダパス |
省略可 |
使用可 |
Googleドライブ上のフォルダを「/」(スラッシュ)から始まる絶対パスで選択または入力します。 |
|
|
ファイル名 |
必須 |
使用可 |
スプレッドシートのファイル名を入力します。 |
|
|
シート名 |
省略可 |
使用可 |
スプレッドシートのシートを選択または入力します。 |
|
|
列一覧 |
省略可 |
|
列を指定します。 列一覧の各列は以下のボタンで操作することができます。
|
|
|
列一覧/列名 |
省略可 |
使用可 |
列名を入力します。 |
|
> プロパティアクション
|
項目名 |
説明 |
備考 |
|---|---|---|
|
フォルダパス一覧の更新 |
指定した接続先にあるフォルダパスを取得して、[フォルダパス]に設定します。 |
|
|
ファイル名一覧の更新 |
指定したフォルダパスにあるファイル名を取得して、[ファイル名]に設定します。 |
|
|
シート名一覧の更新 |
指定したファイルからシート名を取得して、[シート名]に設定します。 |
|
|
列一覧の更新 |
指定したスプレッドシートの1行目の値から列名を取得して、[列一覧]に設定します。 |
|
開始/終了条件
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
読み取り開始条件を指定 |
省略可 |
使用不可 |
読み取り開始条件を指定するかどうかを選択します。
|
|
|
開始条件 |
省略可 |
使用不可 |
読み取り開始条件を選択します。
|
|
|
マッチ文字列 |
省略可 |
使用可 |
読み取り開始条件のマッチ文字列を入力します。 |
|
|
セルアドレス |
省略可 |
使用可 |
読み取り開始条件のセルアドレスを入力します。 |
|
|
読み取り終了条件を指定 |
省略可 |
使用不可 |
読み取り終了条件を指定するかどうかを選択します。
|
|
|
終了条件 |
省略可 |
|
読み取り終了条件を指定します。 各列は以下のボタンで操作することができます。
|
= 備考 =
詳細については、「読み取り終了条件について」を参照してください。 |
|
終了条件/列名 |
省略可 |
使用不可 |
読み取り終了条件のチェックを行う対象の[列名]を選択します。 |
|
|
終了条件/行番号 |
省略可 |
使用可 |
読み取り終了条件のチェックを行う対象の行番号を入力します。 [(指定しない)]を選択した場合、全行を対象に読み取り終了条件のチェックを行います。 |
|
|
終了条件/条件値 |
省略可 |
使用可 |
読み取り終了条件の条件値を入力します。 [(指定しない)]を選択した場合、セルの値に関わらず[行番号]の行が読み取り終了行となります。 |
|
|
終了条件/論理演算子 |
必須 |
使用不可 |
[条件値]の論理演算子を選択します。
|
|
読み取り設定
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
最初の行は値として取得しない |
省略可 |
使用不可 |
指定したスプレッドシートの1行目をデータとして扱うかどうかを選択します。
|
|
データ処理方式
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
データ処理方式 |
必須 |
使用不可 |
データ処理方式を選択します。
|
|
コメント
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
|---|---|---|---|---|
|
コメント |
省略可 |
使用不可 |
このコネクターの簡単な説明を記述することができます。 |
|
スキーマ
入力スキーマ
ありません。
大容量データ処理
大容量データ処理に対応しています。
大容量データ処理を行う場合でも、結果データのファイルへの保存時に、一時的にデータをメモリ中に保持します。そのためデータが大きい場合には、大容量データ処理時にもOutOfMemoryErrorが発生する可能性があります。
使用できるコンポーネント変数
|
コンポーネント変数名 |
説明 |
備考 |
|---|---|---|
|
count |
読み取りを行った行数を返します。 |
注意
PSPでは値が格納されません。 |
|
folderPath |
読み取りを行ったスプレッドシートのフォルダパスを返します。 |
|
|
fileName |
読み取りを行ったスプレッドシートのファイル名を返します。 |
|
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
|
error_type |
エラー発生時、発生したエラーの種類が格納されます。 |
|
|
error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
|
|
error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
|
-
[読み取り終了条件を指定]にチェックを入れない場合、または[終了条件]が1つも存在しない場合、スプレッドシートに存在する行すべてが読み取り対象となります。
-
[終了条件/論理演算子]に複数の[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行も読み取られず処理が終了します。
メッセージコード、例外メッセージ、制限事項
|
コネクター |
メッセージコード |
例外メッセージ |
制限事項 |
|---|---|---|---|
|
|
|
|
