Excel

Excelファイルの操作を行うアクション一覧です。

SelectSheet

概要

SelectSheetは、ワークシートを選択するアクションです。

パラメーター

*は、必須パラメーター

名前 概要
filename* 文字列 使用するExcelのファイル名 +get_file_1
sheetname* 文字列 使用するExcelのシート名 Sheet1
middleware 文字列 使用するミドルウェア名 xlsx

アウトプット

タイプ 概要
Worksheet ワークシート 選択したワークシート ※使用例のアウトプット参照

使用例

+select_sheet_1:
  action>: SelectSheet
  filename: +get_file_1
  sheetname: 'データ'
# => {
#  "filename": "/tmp/1decfdb0-7795-4b7c-a851-668c2b81a067/local/詳細データ集計.xlsx",
#  "sheetname": "データ",
#  "rows": 195
#}

ReadCell

概要

ReadCelltは、セルの値を読み込むアクションです。

パラメーター

*は、必須パラメーター

名前 概要
worksheet* ワークシート 対象のワークシート +select_sheet_1
celllabel* 文字列 読み込むセルラベル A2
middleware 文字列 使用するミドルウェア名 xlsx

アウトプット

タイプ 概要
Anything 返却された値による 取得したセルの値 ※使用例のアウトプット参照

使用例

+read_cell_1:
  action>: ReadCell
  worksheet: +select_sheet_1
  celllabel: G2
# => 157

WriteCell

概要

WriteCellは、セルに値を書き込むアクションです。

パラメーター

*は、必須パラメーター

名前 概要
worksheet* ワークシート 対象のワークシート +select_sheet_1
celllabel* 文字列 読み込むセルラベル A2
value* 文字列 書き込む値 123
middleware 文字列 使用するミドルウェア名 xlsx

アウトプット

タイプ 概要
Worksheet ワークシート 新しいワークシート ※使用例のアウトプット参照

使用例

+write_cell_1:
  action>: WriteCell
  worksheet: +select_sheet_1
  celllabel: A12
  value: 'まとめ'
# => {
#  "filename": "/tmp/0495be82-5eb2-4981-b251-6c39c603a31d/local/集計表.xlsx",
#  "sheetname": "1月",
#  "rows": 12
# }

ReadRange

概要

ReadRangeは、シートの指定した範囲の値を2次元配列に読み込むアクションです。

パラメーター

*は、必須パラメーター

名前 概要
worksheet* ワークシート 対象のワークシート +select_sheet_1
range* 文字列 読み込むセルラベル A1:B10
middleware 文字列 使用するミドルウェア名 xlsx

アウトプット

タイプ 概要
Array 配列 取得した範囲の値を[行][列]の2次元配列として返却します。 ※使用例のアウトプット参照

使用例

+read_range_1:
  action>: ReadRange
  worksheet: +select_sheet_1
  range: 'A1:B10'
# => [
#  [
#    null,
#    "第1週"
#  ],
#  [
#    "林檎",
#    15
#  ],
#  [
#    "みかん",
#    54
#  ],
#  [
#    "キウイ",
#    34
#  ],
#  [
#    "桃",
#    77
#  ],
#  [
#    "八朔",
#    54
#  ],
#  [
#    "オレンジ",
#    98
#  ],
#  [
#    "グレープフルーツ",
#    53
#  ],
#  [
#    "レモン",
#    34
#  ],
#  [
#    "バナナ",
#    65
#  ]
#]

WriteRange

概要

WriteRangeは、シートに配列を書き込むアクションです。

パラメーター

*は、必須パラメーター

名前 概要
worksheet* ワークシート 対象のワークシート +select_sheet_1
table* 配列 書き込む値の配列 [["id","name","age"],["1","taro","23"]]
celllabel* 文字列 書き込む位置のセルラベル A2
middleware 文字列 使用するミドルウェア名 xlsx

アウトプット

タイプ 概要
Worksheet ワークシート 新しいワークシート ※使用例のアウトプット参照

使用例

+write_range_1:
  action>: WriteRange
  worksheet: +select_sheet_1
  table: +create_list_1
  celllabel: A11
# => {
#  "filename": "/tmp/a2f288c8-aec6-4bcc-b4f9-d9858846c928/local/集計表.xlsx",
#  "sheetname": "1月",
#  "rows": 11
# }

WriteCSV

概要

WriteCSVは、CSVファイルに値を書き込むアクションです。

パラメーター

*は、必須パラメーター

名前 概要
filename* 文字列 使用するCSVファイル名 test
table* 配列 書き込む値を配列で指定 [["Name","Female","Age","Address"],["Taro Okamoto","man","67","Osaka"],["Jiro Okamoto","man","64","Tokyo"]]
bom 真理値 BOMの有り無し true(default)

アウトプット

タイプ 概要
File ファイル 作成したCSVファイル /tmp/05dc2b55-526c-404c-998a-fcce0905f377/csv/test.csv

使用例

+write_c_s_v_1:
  action>: WriteCSV
  filename: test
  table: +create_list_1
  bom: true
# => "/tmp/05dc2b55-526c-404c-998a-fcce0905f377/csv/test.csv"

ReadCSV

概要

ReadCSVは、CSVファイルを配列として読み込むアクションです。

パラメーター

*は、必須パラメーター

名前 概要
filename* 文字列 使用するCSVファイル名 +get_file_1
headers 真理値 ヘッダー行を含める場合は、trueとします。 true(default)
encoding 文字列 CSVファイルの文字コードを指定します。デフォルトでは、SHIFT_JISとして読み込みます。サポートされているエンコーディングは表外に記載しました。 shift_jis(default)
delimiter 文字列 デリミタの種類を指定します。 デフォルトでは、commaが指定されています。 comma(default), tab, semicolon
quote 文字列 CSVファイル内でデリミタを含む値に使用する引用符を指定します。 デフォルトでは、doubleQuotationが指定されています。 noSettingsを指定すると、デリミタに指定された値はすべて区切り文字として認識されます。 doubleQuotation(default), singleQuotation, noSettings

サポートされているエンコーディング一覧

utf8, ucs2 / utf16-le, ascii, binary, base64, hex, utf16, utf16-be, utf-7, utf-7-imap, CP932, CP936, CP949, CP950, GB2312, GBK, GB18030, Big5, Shift_JIS, EUC-JP

アウトプット

タイプ 概要
Array 配列 取得した値を二次元配列として返却します。 ※使用例のアウトプット参照

使用例

+read_c_s_v_1:
  action>: ReadCSV
  filename: +get_file_1
  headers: true
  encoding: utf8
  delimiter: comma
# => [
#  [
#    "名前",
#    "性別",
#    "年齢",
#    "住所"
#  ],
#  [
#    "Shane Tremblay",
#    "Male",
#    86,
#    "963 Gerlach Wall, Jeffreyborough, ND 19461"
#  ],
#  [
#    "Renato Schroeder",
#    "Female",
#    28,
#    "796 Pfeffer Points, Mariannamouth, WI 59528"
#  ]
# ]

CSVファイル内でダブルクォーテーションを使用している際に発生するエラーについて

CSVファイル内でデリミタ(区切り文字)の直後にダブルクォーテーションを使用している際に「Failed to parse CSV」というエラーが発生する場合があります。 その際にquoteパラメータに「シングルクォーテーション」もしくは「使用しない」を指定するとエラーが解消する場合があります。\

  • エラーが発生するCSVファイルの例
id, 商品名, 値段
1, sample1, "100"円
2, sample2, "300"円
3, sample3, "500"円

DeleteRange

概要

DeleteRangeは、指定範囲の値を削除するアクションです。

パラメーター

*は、必須パラメーター

名前 概要
worksheet* ワークシート 対象のワークシート +select_sheet_1
label* 文字列 範囲(セルラベル) A2:A10
recalculate 真理値 再計算を実行します。範囲が大きい場合、パフォーマンスに大きく影響します。 false(default)
middleware 文字列 使用するミドルウェア名 xlsx

アウトプット

タイプ 概要
Worksheet ワークシート 新しいワークシート ※使用例のアウトプット参照

使用例

+delete_range_1:
  action>: DeleteRange
  worksheet: +select_sheet_1
  label: 'B10:F10'
# => {
#  "filename": "/tmp/3f7e970d-60a6-4353-8ccf-c4c255986a80/local/集計表.xlsx",
#  "sheetname": "1月",
#  "rows": 10
# }

ChangeFileEncoding

概要

ChangeFileEncodingは、ファイルの文字コードを変換するアクションです。

パラメーター

*は、必須パラメーター

名前 概要
filename* 文字列 変換するファイルを指定します。読み込みに対応しているエンコーディングは表外に記載しました。 +download_file_1
save_as 文字列 変換後のファイルのファイル名を指定します。デフォルトでは、「ファイル名_文字コード.拡張子」で保存されます。 test_utf8.csv
target_encoding* セレクト 変換後の文字コードを指定します。変換に対応しているエンコーディングは表外に記載しました。 UTF8
original_encoding セレクト 元の文字コードを指定します。選択のない場合は、自動で判定されます。変換に対応しているエンコーディングは表外に記載しました。 Shift_JIS

読み込みに対応しているエンコーディング一覧

UTF8, UTF16, UTF16-LE, UTF16-BE, UTF7, UTF7-IMAP, UCS2, ASCII, Binary, Base64, HEX, CP932, CP936, CP949, CP950, GB2312, GBK, GB18030, Big5, Shift_JIS, EUC-JP

変換に対応しているエンコーディング一覧

UTF8, UTF8 (BOM有り), UTF16, UTF16 (BOM有り), UTF16-LE, UTF16-BE, UTF7, UTF7 (BOM有り), UTF7-IMAP, UCS2, ASCII, Binary, Base64, HEX, CP932, CP936, CP949, CP950, GB2312, GBK, GB18030, Big5, Shift_JIS, EUC-JP

アウトプット

タイプ 概要
File ファイル 文字コード変換後のファイル /tmp/05dc2b55-526c-404c-998a-fcce0905f377/test_utf8.csv

使用例

+change_file_encoding_1:
  action>: ChangeFileEncoding
  filename: +get_file_1
  save_as: test.txt
  target_encoding: utf8
  original_encoding: ''
# => "/tmp/05dc2b55-526c-404c-998a-fcce0905f377/test.txt"

results matching ""

    No results matching ""