【公式】[Excel(POI)]セル指定書き込み

オペレーション名

セル指定書き込み

機能概要

入力データをExcelファイルの指定したセルに書き込みます。

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

ただし、[書式・コメントをMapperで指定して書き込む]にチェックを入れた場合、XML型となります。

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。
入力データ	必須	使用不可	スクリプトキャンバス上にあるコンポーネントを選択します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
ファイルパス	必須	使用可	Excelファイルのファイルパスを入力します。 [参照]ボタンをクリックするとファイルチューザーが起動し、ファイルの選択ができます。	注意ファイルパスはHULFT Square ストレージの絶対パスで指定してください。パス区切り文字「/」以外のHULFT Squareストレージの使用禁止文字は使用できません。
セル一覧	必須	-	セルを指定します。各列は以下のボタンで操作することができます。 [上へ] 選択している列の順序を一つ上に上げます。 [下へ] 選択している列の順序を一つ下に下げます。 [追加] 列を追加します。 [削除] 列を削除します。
セル一覧/シート名	必須	使用可	シート名を選択または入力します。	大文字小文字を区別しません。書き込み先にシート名が存在しない場合、シートを作成します。プロパティアクション[シート名の一覧を取得する]からシート名の一覧を取得できます。
セル一覧/セルアドレス	必須	使用可	書き込むセルアドレスを入力して、指定します。	セルアドレスはA1形式またはR1C1形式で指定できます。 A1形式で指定する場合例：「A1」「B2」 R1C1形式で指定する場合例：「R1C1」「R5C12」
セル一覧/セルラベル	省略可	使用不可	セルのラベルを入力します。	[セルラベル]に設定した値がMapperのスキーマに表示されます。実行時には使用されません。
セル一覧/型	必須	使用不可	セルの型を選択します。 [文字列] (デフォルト) 内部データ型はStringです。 [数値] 内部データ型はBigDecimalです。 [日付] 内部データ型はDateです。 [時間] 内部データ型はDateです。 [真偽値] 内部データ型はbooleanです。	内部データ型の詳細については、「内部データ型」を参照してください。 [時間]を選択した場合、年月日の値は使用されません。
セル一覧/表示形式設定	必須	使用不可	表示形式の設定方法を選択します。 [表示形式を指定する] セルの表示形式を指定します。 [セルの表示形式を利用する] (デフォルト) 書き込み先セルの表示形式を利用します。	[セルの表示形式を利用する]を選択した場合、[列一覧/表示形式]で設定した表示形式は使用されません。
セル一覧/表示形式	省略可	使用可	書き込み先のセルに設定する表示形式を選択または入力します。
書式・コメントをMapperで指定して書き込む	省略可	使用不可	書式・コメントを書き込むための要素を入力スキーマに設定するかどうかを選択します。 [チェックあり] 書式・コメントを書き込むための要素を入力スキーマに設定します。 [チェックなし] (デフォルト) 書式・コメントを書き込むための要素を入力スキーマに設定しません。	[チェックあり]の場合、入力スキーマはXML型となります。 = 備考 = 詳細については、「入力スキーマ」を参照してください。

プロパティアクション

項目名	説明	備考
シート名の一覧を取得する	[ファイルパス]で指定したファイルからシート名の一覧を取得します。	指定したファイルが存在しない場合、または[ファイルパス]にスクリプト変数が設定されている場合は無効になります。

書き込み設定

項目名	必須/省略可	変数の使用	説明	備考
シートの追加位置	必須	使用不可	シートを作成する際に追加する位置を選択します。 [先頭に追加する] (デフォルト) 先頭にシートを追加します。 [末尾に追加する] 末尾にシートを追加します。

項目名

必須/省略可

変数の使用

説明

備考

シートの追加位置

必須

使用不可

シートを作成する際に追加する位置を選択します。

[先頭に追加する]

(デフォルト)

先頭にシートを追加します。

[末尾に追加する]

末尾にシートを追加します。

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このコネクターの簡単な説明を記述することができます。

スキーマ

入力スキーマ

[書式・コメントをMapperで指定して書き込む]にチェックを入れない場合
- テーブルモデル型となります。
- [セル一覧]の設定により、カラム数が異なります。
- = 備考 =
  スキーマ構造については、「テーブルモデル型」を参照してください。

[書式・コメントをMapperで指定して書き込む]にチェックを入れた場合

XML型となります。

スキーマ構造については、以下のとおりです。

<?xml version="1.0" encoding="UTF-8"?>
<table>
  <row>
    <column>
      <format></format>
    </column>
    <column>
      <format></format>
    </column>
       :
  </row>
</table>

要素名	属性名	説明	備考
table	-
row	-
column	-	セルに書き込む値を表します。	[セル一覧]で設定した列ごとに出現します。
format	-	セルに書き込む書式・コメントを表します。	この要素には、「Excel書式生成」ロジックから出力された文字列を入力してください。「Excel書式生成」ロジックから出力されない書式・コメントは書き込まれません。書き込まれない書式については、書き込み先セルの書式が使用されます。

出力スキーマ

ありません。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

= 備考 =

詳細については、「スキーマ編集」を参照してください。

トランザクション

トランザクションをサポートしています。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
filePath	ファイルのパスが格納されます。	デフォルト値はnullです。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。

メッセージコード、例外メッセージ、制限事項

コネクター	メッセージコード	例外メッセージ	制限事項
Excel(POI) コネクターのメッセージおよび制限事項

注意事項

繰り返し処理中に配置する場合は繰り返し処理(データ件数)の注意事項を参照してください。

セル指定書き込み処理