シートのコピー処理

オペレーション名

シートのコピー

機能概要

指定されたExcelブックのシートをコピーします。

プロパティ

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

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	補足
コピー元ファイル	必須	使用可	コピー元のExcelブック形式のファイルパスを入力します。 [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。	拡張子が「.xlsx」と「.xlsm」であるExcelブック形式のファイルパスを指定します。ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。
コピー先ファイル	必須	使用可	コピー先のExcelブック形式のファイルパスを入力します。コピー元のExcelブックと同じファイルを指定することも出来ます。 [参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。	拡張子が「.xlsx」と「.xlsm」であるExcelブック形式のファイルパスを指定します。ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。指定したファイルが存在しない場合、新規Excelブックファイルが作成されます。
シート一覧	省略可	-	コピー対象のシートを指定します。	省略した場合には、すべてのシートをコピーします。
シート一覧/コピー元シート名	必須	使用可	[コピー元ファイル]で指定したExcelファイルに含まれる、コピーするシートを選択または入力します。	大文字小文字を区別します。
シート一覧/コピー先シート名	必須	使用可	[コピー先ファイル]で指定したExcelファイルにおける、コピーした後のシート名を入力します。	大文字小文字を区別します。 [コピー先ファイル]で指定したExcelファイルに含まれないシート名を入力してください。

トランザクション

項目名	必須/省略可	変数の使用	説明	備考
トランザクション処理を行う	省略可	使用不可	トランザクション処理を行うかどうかを選択します。 [チェックあり]: トランザクション処理を行います。 [チェックなし]:(デフォルト) トランザクション処理を行いません。詳細については、「ファイル系アダプタのトランザクション」を参照してください。

コメント

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このアダプタの簡単な説明を記述することができます。説明を記述すると、仕様書に反映させることができます。

スキーマ

入力スキーマ

ありません。

出力スキーマ

ありません。

トランザクション

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

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

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のバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

仕様制限

Excelブックのみ対応しています。

マクロのコピーには対応していません。ただし、マクロが登録されているオートシェイプはそのままコピーします。このため、コピー先に同名のマクロが既に存在していた場合には、オートシェイプからそのマクロを実行できる可能性があります。

ピボットテーブルのコピーには対応していません。ブックが破損する場合があります。

外部参照(リンク)のコピーには対応していません。ブックが破損する場合があります。

[シート一覧]に複数の設定をした場合、順に処理を行います。

ブック内のすべての文字列をメモリ上に保持します。このため、大容量データのブックを扱う場合にはメモリ領域を大きくする必要があります。

主な例外

例外名	原因	対策
InvalidPropertyConfigurationException ファイルパスが指定されていません。	[コピー元ファイル]または[コピー先ファイル]が指定されていません。	[コピー元ファイル]と[コピー先ファイル]を指定してください。
InvalidPropertyConfigurationException 対応していない形式のブックが指定されています。	[コピー元ファイル]または[コピー先ファイル]に対応していない形式のブックが指定されています。	[コピー元ファイル]と[コピー先ファイル]に対応している形式のブックを指定してください。
FileIsDirectoryException	[コピー元ファイル]または[コピー先ファイル]に入力されたパスがディレクトリです。	[コピー元ファイル]と[コピー先ファイル]にはファイルパスを入力してください。
FileIsLockedException	[コピー元ファイル]または[コピー先ファイル]に指定されたファイルがロックされています。	エクスプローラやCLIからロックの解除を行ってください。
java.io.FileNotFoundException	[コピー元ファイル]に指定されたファイルが存在しません。	[コピー元ファイル]を確認してください。
java.io.FileNotFoundException 別のプロセスが使用中です。	[コピー元ファイル]または[コピー先ファイル]に指定されたファイルが別のプロセスによって使用されています。	別のプロセスで使用されていないかを確認してください。
SheetNotFoundException 存在しないシート名が指定されました。	[コピー元シート名]に指定されたシートが存在しません。	[コピー元シート名]には存在するシート名を指定してください。
SheetAlreadyExistsException 指定したシートは既に存在しています。	[コピー先シート名]に指定されたシートが既に存在しています。	[コピー先シート名]には存在しないシート名を指定してください。

注意事項

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