セル指定書き込み処理

オペレーション名

セル指定書き込み

機能概要

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

データモデル

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

プロパティ

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

基本設定

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

必須設定

項目名	必須/省略可	変数の使用	説明	備考
ファイルパス	必須	使用可	Excelファイルのファイルパスを入力します。 [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。	ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。
セル一覧	必須	-	セルを指定します。各列は以下のボタンで操作することができます。 [上へ]: 選択している列の順序を一つ上に上げます。 [下へ]: 選択している列の順序を一つ下に下げます。 [追加]: 列を追加します。 [削除]: 列を削除します。
セル一覧/シート名	必須	使用可	シート名を選択または入力します。	大文字小文字を区別しません。書き込み先にシート名が存在しない場合、シートを作成します。プロパティアクション[シート名の一覧を取得する]からシート名の一覧を取得できます。
セル一覧/セルアドレス	必須	使用可	書き込むセルアドレスを入力して、指定します。	セルアドレスは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」 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

仕様制限

入力スキーマのcolumn要素にnullを入力した際は空文字で書き込まれます。
入力データが2行以上の場合、1行目の入力データのみを書き込みます。
セルの表示形式が確定されずに書き込まれる場合があります。
パスワードを使用して暗号化されているファイルに書き込むことはできません。
数式の書き込みはサポートしていません。
デジタル署名が追加されたファイルへの書き込みはサポートしていません。
シートの保護およびブックの保護が設定されているファイルに書き込み処理を実行すると書き込みが行われ、パスワードが設定されている場合、パスワードは保持されます。
「Excel書式生成」ロジックで[背景色]を指定した場合、塗りつぶしの背景色以外の要素には既定の値が設定されます。
書き込みパスワードが設定されているファイルに書き込み処理を実行すると、書き込みが行われパスワードは保持されます。
サイズが大きいファイルを[ファイルパス]に指定した場合、OutOfMemoryErrorが発生することがあります。

主な例外

例外名	原因	対策
InputDataNotFoundException	[入力データ]が指定されていません。	[入力データ]を指定する、またはデータフローを引いてください。
ToFormatException	入力スキーマの format要素に入力された値が不正です。	Mapperで「Excel書式生成」ロジックから出力した値を入力するか、不要な場合は値を入力しないようにしてください。
javax.json.JsonException	入力スキーマの format要素に入力された値が不正です。	Mapperで「Excel書式生成」ロジックから出力した値を入力するか、不要な場合は値を入力しないようにしてください。
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。
FileIsDirectoryException	[ファイルパス]に入力されたパスがディレクトリです。	[ファイルパス]にはファイルパスを入力してください。
org.apache.poi.openxml4j.exceptions.OLE2NotOfficeXmlFileException	[ファイルパス]に指定されたExcelファイルは、読み取りパスワードが設定されています。	[ファイルパス]には読み取りパスワードが設定されていないExcelファイルを入力してください。
org.apache.poi.openxml4j.exceptions.NotOfficeXmlFileException	[ファイルパス]に指定されたExcelファイルが不正な状態になっています。	以下のことを確認してください。 Excelファイルではないファイルを[ファイルパス]に指定していないかファイルが破損していないか
org.apache.poi.EmptyFileException
org.apache.poi.openxml4j.exceptions.InvalidFormatException
FileIsLockedException	[ファイルパス]に指定されたファイルがロックされています。	エクスプローラやCLIからロックの解除を行ってください。
java.io.FileNotFoundException 別のプロセスが使用中です。	[ファイルパス]に指定されたファイルが別のプロセスによって使用されています。	別のプロセスで使用されていないかを確認してください。
InvalidPropertyConfigurationException 指定したセルアドレスは不正です。	[セル一覧/セルアドレス]に入力されたセルアドレスが不正です。	[セル一覧/セルアドレス]を確認して正しいセルアドレスを入力してください。
InvalidPropertyConfigurationException セルアドレスが範囲を超えています。[<セルアドレス>]	[セル一覧/セルアドレス]で指定したセルアドレスが最大値を超えています。	[セル一覧/セルアドレス]の値を確認してください。

注意事項

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