セル指定書き込み処理

オペレーション名

セル指定書き込み

機能概要

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

データモデル

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

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

プロパティ

= 備考 =

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

基本設定

項目名

必須/省略可

変数の使用

説明

補足

名前

必須

使用不可

スクリプトキャンバス上での名前を入力します。

 

入力データ

必須

使用不可

スクリプトキャンバス上にあるコンポーネントを選択します。

 

必須設定

項目名

必須/省略可

変数の使用

説明

補足

ファイル

必須

使用可

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

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

  • 拡張子が「.xlsx」と「.xlsm」であるファイルはExcelブックとして、それ以外の拡張子のファイルはExcel 2003ブックとして処理されます。

注意

セル設定

省略可

-

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

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

[上へ]

選択している列の順序を一つ上に上げます。

[下へ]

選択している列の順序を一つ下に下げます。

[追加]

列を追加します。

[削除]

列を削除します。

 

セル設定/シート名

必須

使用可

[ファイル]で指定した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」

error_message

エラー発生時、発生したエラーのメッセージが格納されます。

  • デフォルト値はnullです。

error_trace

エラー発生時、発生したエラーのトレース情報が格納されます。

  • デフォルト値はnullです。

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

コネクター

メッセージコード

例外メッセージ

制限事項

Excel コネクターのメッセージおよび制限事項

check

check

check