セル指定書き込み処理

オペレーション名

セル指定書き込み

機能概要

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

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。
ただし、[書式・コメントをMapperで指定して書き込む]にチェックを入れた場合、XML型となります。

プロパティ

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

基本設定

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

必須設定

項目名

必須/省略可

変数の使用

説明

補足

ファイル

必須

使用可

Excelファイルのファイルパスを入力します。

[参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。

拡張子が「.xlsx」と「.xlsm」であるファイルはExcelブックとして、それ以外の拡張子のファイルはExcel 2003ブックとして処理されます。
ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。
パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。

セル設定

省略可

書き込み対象のセルを指定します。

各列は以下のボタンで操作することができます。

[追加]:
列を追加します。
[上へ]:
選択している列の順序を一つ上に上げます。
[下へ]:
選択している列の順序を一つ下に下げます。
[削除]:
列を削除します。

セル設定/シート名

必須

使用可

[ファイル]で指定したExcelファイルのシートを選択または入力します。

存在しないシート名を入力した場合、入力したシートをブックの先頭に作成します。
大文字小文字を区別しません。

セル設定/セルアドレス

必須

使用可

書き込み対象のセルアドレスを入力します。
例:A1

セル設定/セル名

省略可

使用可

各セルに対するセル名を入力します。

[セル名]に設定された値がMapperのスキーマに表示されます。書き込み時には使用されません。

セル設定/書式設定

必須

使用不可

型・フォーマットの情報を書き込むかどうかを選択します。

[書式を指定して書き込む]:
設定した型・フォーマット情報を書き込みます。
[書き込み先の書式を利用する]:(デフォルト)
書き込むセルの型・フォーマット情報を利用して書き込みます。

[書き込み先の書式を利用する]を選択した場合、[セル設定/型]および[セル設定/フォーマット]で設定した型・フォーマット情報は使用されません。

セル設定/型

必須

使用不可

書き込み対象のセルの型を選択します。

[標準]:(デフォルト)
[文字列]:
[数値]:
[日付]:

セル設定/フォーマット

省略可

使用可

各型に対するフォーマットを選択または入力します。

記号	意味	指定可能な型	例
yyyy	1900～9999(西暦の年)	日付	2005
yy	00～99(西暦の年)	日付	05
m	1～12(月の数字表記)	日付	1
mm	01～12(月の数字表記)	日付	01
mmm	Jan～Dec(月の短縮英語表記)	日付	Jan
mmmm	January～December(月の英語表記)	日付	January
mmmmm	J～D(月のアルファベット1文字目)	日付	J
d	1～31(日)	日付	1
dd	01～31(日)	日付	01
ddd	Sun～Sat(曜日の短縮英語表記)	日付	Mon
dddd	Sunday～Saturday(曜日の英語表記)	日付	Monday
h	時(1～12)	日付	1
hh	時(0～23)	日付	01
h:m	時分	日付	1:1
h:mm	時分	日付	1:01
h:mm:s	秒	日付	1:01:1
h:mm:ss	秒	日付	1:01:01
#,##0	通貨	数値	123,0
0%	パーセンテージ	数値	50%
#	有効な数字の桁のみを表示	数値	フォーマット: ##.## 入力値: 12.345 出力値: 12.35
0	指定された桁数分だけ表示し、値が桁数に満たない場合は0を補完します	数値	フォーマット: 000.00 入力値: 12.345 出力値: 012.35

書式・コメントを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	-	セルに書き込む書式・コメントを表します。	この要素には、Mapperで「Excel書式生成」ロジックから出力された文字列を入力してください。 [セル設定/書式設定]で選択した書式を上書きするかたちで、「Excel書式生成」ロジックから出力した書式・コメントが書き込まれます。「Excel書式生成」ロジックから出力しない書式・コメントは書き込まれません。書き込まれない書式については、[セル設定/書式設定]で選択した書式がそのまま使用されます。何も入力しない場合、書式・コメントは書き込まれません。[セル設定/書式設定]で選択した書式がそのまま使用されます。

出力スキーマ

ありません。

Mapperでのスキーマ読み込み

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

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

トランザクション

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

[トランザクション]の[トランザクション処理を行う]にチェックを入れた場合のみトランザクションは有効になります。

PSPでの使用について

PSPでは使用できません。

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

コンポーネント変数名	説明	備考
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

仕様制限

入力スキーマのcolumn要素にnullを入力した際の動作は、以下の通りです。
- [書式・コメントをMapperで指定して書き込む]にチェックを入れない場合
  - 書き込みを行いません。
- [書式・コメントをMapperで指定して書き込む]にチェックを入れた場合
  - 入力スキーマがXML型となるため、空文字としてセルに書き込みを行います。
入力データが複数行の場合、1行目のデータを書き込みます。

表示形式が「日付」のセルに文字列型の入力データを書き込む場合、以下の日付フォーマット形式または、system.propertiesの「xmlfw.daterenderingformat」プロパティで指定した日付フォーマット形式でフォーマットされたデータを使用してください。

詳細については、「プロパティリファレンス」を参照してください。

フォーマット	例
yyyy-MM-dd'T'HH:mm:ss.SSSZZ	2007-05-10T15:32:12.708+0900
yyyy-MM-dd'T'HH:mm:ss.SSS	2007-05-10T15:32:12.708
yyyy-MM-dd'T'HH:mm:ssZZ	2007-05-10T15:32:12+0900
yyyy-MM-dd'T'HH:mm:ss	2007-05-10T15:32:12
yyyy-MM-dd'T'HH:mm	2007-05-10T15:32
yyyy-MM	2007-05
yyyy/M/d K:m a	2007/5/10 3:32 午後
yyyy/M/d H:m:s	2007/05/10 15:32:12
yyyy/M/d H:m	2007/05/10 15:32
yyyy/M/d	2007/05/10
yyyy年M月d日H時m分s秒	2007年05月10日15時32分12秒
yyyy年M月d日H時m分	2007年05月10日15時32分
yyyy年M月d日H時	2007年05月10日15時
yyyy年M月d日H:m:s	2007年05月10日15:32:12
yyyy年M月d日H:m	2007年05月10日15:32
yyyy年M月d日 H時m分s秒	2007年05月10日 15時32分12秒
yyyy年M月d日 H時m分	2007年05月10日 15時32分
yyyy年M月d日 H時	2007年05月10日 15時
yyyy年M月d日 H:m:s	2007年05月10日 15:32:12
yyyy年M月d日 H:m	2007年05月10日 15:32
yyyy年M月d日	2007年05月10日
yyyy年M月	2007年05月

[セル設定/書式設定]に[書き込み先の書式を利用する]が選択されている際に、書き込み先のセルの日付フォーマットが以下の場合には、日付型のデータを書き込んでも表示形式が「日付」になりません。

日付フォーマットの型	表示例	備考
m"月"d"日";@	3月14日
[$-411]ggge"年"m"月"d"日";@	平成13年3月14日
[$-411]ge.m.d;@	h13.3.14
[$-409]yyyy/m/d h:mm AM/PM;@	13/3/14 1:30 PM	書き込み先のセルにデータが入っている場合は日付として書き込むことができます。

ユーザー定義の表示形式は未検証となります。

時分秒フォーマットの入力データは、表示形式が「日付」ではなく「標準」で書き込まれます。

書き込み処理後、セルの表示形式が確定されずに書き込まれる場合があります。

パスワードを使用して暗号化されているExcelファイルに書き込むことはできません。

デジタル署名が追加されたExcelファイルへの書き込みはサポートしていません。

シートの保護が設定されているExcelファイルに書き込み処理を実行すると書き込みが行われ、パスワードが設定されている場合、パスワードは保持されます。

「Excel書式生成」ロジックで[背景色]を指定した場合、塗りつぶしの背景色以外の要素には既定の値が設定されます。

Excel 2003ブックで、表示形式が「標準」のセルに数値を書き込んだ場合、数値が文字列として書き込まれ、エラーチェックが表示されます。
表示形式が「数値」のセルでも、書き込み対象のセルに値が入っていない場合、エラーチェックが表示されることがあります。

Excel 2003ブックで、値が入っていないセルに書き込みを行う場合、セルのフォント情報が取得できず、フォント「Arial」・フォントサイズ「10」で書き込まれることがあります。
この場合、書き込み先のセルに値を入れておくことで、書き込み先のセルのフォント情報を使用して書き込むことができます。

Excel 2003ブックで、以下4つの条件をすべて満たす場合、「Excel書式生成」ロジックで書式を指定しても書き込み先のセルに反映されません。
- [セル設定/書式設定]で[書き込み先の書式を利用する]を選択している
- 書き込み先セルにコメントが挿入されている
- 書き込み先セルに値が入っていない
- 書き込み先セルに書式が何も設定されていない
Excel 2003ブックに書き込みを行う場合、書き込みパスワードが設定されているブックに書き込み処理を実行すると、書き込みが行われパスワードは削除されます。

Excel 2003ブックに書き込みを行う場合、[ファイル]に指定したファイル内のすべてのセルについて、以下の書式は、セル全体の書式設定に変更されます。
- フォント名
- フォントスタイル
- フォントサイズ
- 下線
- フォントの色
- 文字飾り

Excel 2003ブックに書き込みを行う場合、[ファイル]に指定したファイル内の以下の設定は書き込み時に消失します。
- テキストボックス
- オートシェイプ
- ピボットテーブル
- ラベル
- グループボックス
- チェックボックス
- オプションボタン
- リストボックス
- スクロールバー
- スピンボタン
- ワードアート
- オートフィルタ
- セルの書式設定で指定された斜め罫線
- シート見出しの色
- 範囲の編集の許可
Excel 2003ブックに書き込みを行う場合、[ファイル]に指定したファイル内のセルに「選択範囲内で中央」の設定がされていると、書き込み時に表示形式が「標準」に変更されます。

Excelブックに書き込みを行う場合、書き込みパスワードが設定されているブックに書き込み処理を実行すると、書き込みが行われパスワードは保持されます。

Excelブックに書き込みを行う場合、先頭に「+」(半角プラス記号)がある数値を書き込むと、文字列として書き込まれブックが破損した状態になります。

主な例外

例外名	原因	対策
InputDataNotFoundException	[入力データ]が指定されていません。	[入力データ]を指定する、またはデータフローを引いてください。
InputDataReadException 書式を入力データから読み込むのに失敗しました。	入力スキーマのformat要素に入力された値が不正です。	Mapperで「Excel書式生成」ロジックから出力した値を入力するか、不要な場合は値を入力しないようにしてください。
InvalidPropertyConfigurationException ファイルパスが指定されていません。	[ファイル]が指定されていません。	[ファイル]を指定してください。
InvalidPropertyConfigurationException 書き込み先のセルが指定されていません。	[セル設定]が指定されていません。	[セル設定]を指定してください。
InvalidPropertyConfigurationException シート名が指定されていません。	[セル設定/シート名]が指定されていません。	[セル設定/シート名]を指定してください。
InvalidPropertyConfigurationException セルアドレスが指定されていません。	[セル設定/セルアドレス]が指定されていません。	[セル設定/セルアドレス]を指定してください。
InvalidCellAddressException 指定したセルアドレスは不正です	[セル設定/セルアドレス]に入力されたセルアドレスが不正です。	[セル設定/セルアドレス]を確認して正しいセルアドレスを入力してください。
FileIsDirectoryException	[ファイル]に入力されたパスがディレクトリです。	[ファイル]にはファイルパスを入力してください。
IllegalFormatException	[セル設定]で指定した[型]に対する入力データ、または[フォーマット]が不正です。	型と入力データ、フォーマットの組み合わせを確認してください。
IllegalTargetWorkbookException	指定したブックが書き込める状態ではありません。	ほかのプログラムが参照している、またはブックの形式が破損している可能性があります。
FileIsLockedException	[ファイル]に指定されたファイルがロックされています。	エクスプローラやCLIからロックの解除を行ってください。
java.io.FileNotFoundException 別のプロセスが使用中です。	[ファイル]に指定されたファイルが別のプロセスによって使用されています。	別のプロセスで使用されていないかを確認してください。
jxl.read.biff.PasswordException	[ファイル]に指定されたExcel 2003ブックは、読み取りパスワードが設定されています。	[ファイル]には読み取りパスワードが設定されていないExcel 2003ブックを入力してください。
jxl.write.biff.RowsExceededException	[セルアドレス]で指定した行番号が最大値を超えています。	[セルアドレス]の値を確認してください。
jxl.read.biff.BiffException Unable to recognize OLE stream	[ファイル]で指定しているExcel　2003ブックが不正な状態になっています。	以下のことを確認してください。 [ファイル]で指定しているファイルがサポートバージョンに含まれるExcel 2003ブックであるか Excel 2003ブックではないファイルを拡張子「.xls」に設定して[ファイル]に指定していないかファイルが破損していないか
jxl.read.biff.BiffException The file format is corrupt	[ファイル]で指定しているExcel 2003ブックが破損している可能性があります。	以下のことを確認してください。 [ファイル]で指定しているファイルが破損していないか確認してください。
jxl.read.biff.BiffException The input file was not found	[ファイル]で指定しているExcel 2003ブックが不正な状態になっています。	以下のことを確認してください。 0バイトのファイルを指定していないか
ZipEntryBrokenException: 操作するZIPファイルのエントリーが壊れています	[ファイル]に指定しているExcelブックが不正な状態になっています。	以下のことを確認してください。 [ファイル]で指定しているファイルがExcelブックであるか Excelブックではないファイルを拡張子「.xlsx」「.xlsm」に設定して[ファイル]に指定していないかファイルが破損していないか
ZipEntryNotFoundException: 指定した名前のエントリーはzipファイル内に存在しませんでした	[ファイル]に指定しているExcelブックに読み取りパスワードが設定されているか、不正な状態になっています。	[ファイル]に指定しているExcelブックに読み取りパスワードが設定されていないか、またファイルが破損していないかを確認してください。

注意事項

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