シート名一覧取得処理

オペレーション名

シート名一覧取得

機能概要

Excelファイルに含まれるシート名一覧を取得します。

データモデル

本コンポーネントのデータモデルはXML型です。
入出力のスキーマについては「スキーマ」を参照してください。

プロパティ

基本設定

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

必須設定

項目名 必須/省略可 変数の使用 説明 補足
ファイル 必須 使用可 Excelブック形式のファイルパスを入力します。

[参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。
  • 拡張子が「.xlsx」と「.xlsm」であるファイルはExcel 2007ブックとして、それ以外の拡張子のファイルはExcel 2003/XP/2000ブックとして処理されます。
  • ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。
  • パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。

コメント

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

スキーマ

<?xml version="1.0" encoding="UTF-8"?>
<book>
 <sheet><![CDATA[Sheet1]]></sheet>
 <sheet><![CDATA[Sheet2]]></sheet>
 <sheet><![CDATA[Sheet3]]></sheet>
 　:
 　:
</book>

Mapperでのスキーマ読み込み

入出力スキーマは手動で読み込む必要があります。
読み取りを行うデータのスキーマを指定してください。

大容量データ処理

大容量データ処理に対応していません。

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

コンポーネント変数名 説明
count 入力データの行数を返します。
filePath ファイルのパスを返します。
error_type エラーが発生したときに、エラーの種類を返します。
java.io.FileNotFoundExceptionというような形式で返されます。
エラーが発生しなかった時にはnullを返します。
バージョンにより、内容が変わる可能性があります。
error_message エラーが発生したときのエラーメッセージを返します。
バージョンにより、内容が変わる可能性があります。
error_trace エラーが発生したときのトレース情報を返します。
バージョンにより、内容が変わる可能性があります。

主な例外

例外名 原因 対策
InvalidPropertyConfigurationException
<プロパティ名>が指定されていません。		 [<プロパティ名>]が指定されていません。 [<プロパティ名>]を指定してください。
FileIsDirectoryException [ファイル]に入力されたパスがディレクトリです。 [ファイル]にはファイルパスを入力してください。
java.io.FileNotFoundException [ファイル]に指定されたファイルが存在しません。 [ファイル]を確認してください。
jxl.read.biff.PasswordException [ファイル]に指定されたExcelブックは、読み取りパスワードが設定されています。 [ファイル]には読み取りパスワードが設定されていないExcelブックを入力してください。
jxl.read.biff.BiffException
Unable to recognize OLE stream 		[ファイル]で指定しているExcelブックが不正な状態になっています。 以下のことを確認してください。
  • [ファイル]で指定しているファイルがサポートバージョンに含まれるExcelブックであるか
  • Excelブックではないファイルを拡張子「.xls」に設定して[ファイル]に指定していないか
  • ファイルが破損していないか
ZipEntryBrokenException:
操作するZIPファイルのエントリーが壊れています		 [ファイル]に指定しているExcel 2007ブックが不正な状態になっています。 以下のことを確認してください。
  • [ファイル]で指定しているファイルがExcel 2007ブックであるか
  • Excel 2007ブックではないファイルを拡張子「.xlsx」「.xlsm」に設定して[ファイル]に指定していないか
  • ファイルが破損していないか
ZipEntryNotFoundException:
指定した名前のエントリーはzipファイル内に存在しませんでした		 [ファイル]に指定しているExcel 2007ブックが読み取りパスワードが設定されているか、不正な状態になっています。 [ファイル]に指定しているExcel 2007ブックに読み取りパスワードが設定されていないか、またファイルが破損していないかを確認してください。