ファイル/フォルダ読み取り処理

オペレーション名

ファイル/フォルダ読み取り

機能概要

Googleドライブ上にあるファイル/フォルダを取得して、DataSpiderファイルシステム上のディレクトリに書き込みます。

データモデル

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

プロパティ

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

基本設定

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

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
ドライブタイプ	必須	使用不可	処理を行うドライブを選択します。 [マイドライブ]:(デフォルト) 処理対象を「マイドライブ」に設定します。 [共有ドライブ]: 処理対象を「共有ドライブ」に設定します。
共有ドライブ名	必須	使用可	共有ドライブ名を選択または入力します。	[ドライブタイプ]に[共有ドライブ]を選択した場合、有効になります。
フォルダパス	必須	使用可	Googleドライブのフォルダパスを入力します。	フォルダパスはGoogleドライブの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。
ファイル/フォルダ名	必須	使用可	ファイル/フォルダを指定します。	ファイル/フォルダ名にはワイルドカード(「*」および「?」)が使用できます。
ローカルディレクトリ	必須	使用可	DataSpiderファイルシステムのディレクトリパスを入力します。 [参照]ボタンを押下するとディレクトリチューザが起動し、ディレクトリの選択ができます。	ディレクトリパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。大文字小文字を区別しません。
ファイルが存在する場合は上書きする	省略可	使用不可	指定したローカルディレクトリに同名のファイルが存在した場合に上書きするかどうかを選択します。 [チェックあり]:(デフォルト) 指定したローカルディレクトリに同名のファイルが存在した場合に上書きします。 [チェックなし]: 指定したローカルディレクトリに同名のファイルが存在した場合に上書きせずエラーとします。
再帰的に処理する	省略可	使用不可	指定したフォルダについて、再帰的にファイル/フォルダを取得するかどうかを選択します。 [チェックあり]: 指定したフォルダにフォルダが含まれる場合、再帰的にファイル/フォルダを取得します。 [チェックなし]:(デフォルト) 指定したフォルダ内のファイルのみ取得します。

プロパティアクション

項目名	説明	備考
共有ドライブ名一覧の更新	指定した接続先にある共有ドライブを取得して、[共有ドライブ名]に設定します。	[接続先]が指定されていない場合、または[ドライブタイプ]に[マイドライブ]を選択した場合は無効になります。 [接続先]を指定・変更した場合や、Googleドライブ上でドライブの追加・変更を行った場合、本プロパティアクションを使用することでその変更を反映させることができます。
フォルダパス一覧の更新	指定した接続先にあるフォルダパスを取得して、[フォルダパス]に設定します。	以下の場合は本プロパティアクションが無効になります。 [接続先]が指定されていない場合 [共有ドライブ名]が指定されていない場合 [共有ドライブ名]にスクリプト変数が設定されている場合 [接続先]および[共有ドライブ名]を指定・変更した場合や、Googleドライブ上でフォルダの追加・変更を行った場合、本プロパティアクションを使用することでその変更を反映させることができます。
ファイル/フォルダ名一覧の更新	指定したフォルダパスにあるファイル/フォルダ名を取得して、[ファイル/フォルダ名]に設定します。	[フォルダパス]を指定・変更した場合や、Googleドライブ上でファイル/フォルダの追加・変更を行った場合、本プロパティアクションを使用することでその変更を反映させることができます。 [フォルダパス]に変数が設定されている場合は無効になります。

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

スキーマ

入力スキーマ

ありません。

出力スキーマ

<?xml version="1.0"?>
<server>
  <files drivename="" drivetype="">
    <file etag="" localpath="" md5checksum="" name="" remotepath="" size="" status="" type="" updated="" />
  </files>
</server>

要素名	属性名	説明	備考
server	-
files	-
	drivename	取得した共有ドライブ名を出力します。
	drivetype	取得したドライブタイプを出力します。
file	-	取得したファイル/フォルダごとに出現します。
	etag	-	仕様制限を参照してください。
	localpath	取得したファイル/フォルダのローカルパスを出力します。	statusが「ErrorRemoteFolderNotFound」の場合は値が空白になります。
	md5checksum	取得したファイルのMD5チェックサムを出力します。	ファイル/フォルダが正常に取得された場合に出力されます。フォルダの場合は常に空白になります。 Google形式のファイルは常に空白になります。
	name	取得したファイル/フォルダの名前を出力します。	statusが「ErrorRemoteFolderNotFound」の場合は値が空白になります。
	remotepath	取得したファイル/フォルダのGoogleドライブ上のファイルパスを出力します。
	size	取得したファイル/フォルダのサイズを出力します。単位はバイトです。	ファイル/フォルダが正常に取得された場合に出力されます。フォルダの場合は常に「0」が出力されます。 Google形式のファイルは常に「0」が出力されます。
	status	取得したファイル/フォルダの状態を出力します。 Exist:ファイル/フォルダが存在している状態です。 ErrorRemoteDriveNotFound:Googleドライブ上に、指定した[共有ドライブ名]が存在しない状態です。 ErrorRemoteFolderNotFound:Googleドライブ上に、指定した[フォルダパス]が存在しない、またはファイルを指定した状態です。 ErrorRemoteFileNotFound:Googleドライブ上で、指定した[フォルダパス]内に指定したファイル/フォルダが存在しない状態です。 ErrorLocalFileNotFound:指定した[ローカルディレクトリ]が存在しない、またはファイルを指定した状態です。 ErrorLocalFileExist:[ファイルが存在する場合は上書きする]が[チェックなし]で、指定した[ローカルディレクトリ]内に同名ファイルが存在した状態です。 Error:エラーが発生したため、ファイル/フォルダの読み取りができなかった状態です。
	type	取得したファイル/フォルダの種別を出力します。 File:ファイル Folder:フォルダ
	updated	取得したファイル/フォルダの最終更新日時を出力します。	ファイル/フォルダが正常に取得された場合に出力されます。システムプロパティ内の「xmlfw.daterenderingformat」で設定されたフォーマットで出力されます。設定されていない場合には、デフォルトの形式「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」で出力されます。例:2007-10-16T13:15:22.738+0900 タイムゾーンはDataSpiderServerのタイムゾーンになります。

Mapperでのスキーマ読み込み

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

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

大容量データ処理

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

大容量のファイルの取得は対応しています。

PSPでの使用について

PSPでは使用できません。

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

コンポーネント変数名	説明	備考
count	取得したフォルダおよびファイルの数が格納されます。	デフォルト値はnullです。「folder_count」と「file_count」の合計です。
folder_count	取得したフォルダの数が格納されます。	デフォルト値はnullです。
file_count	取得したファイルの数が格納されます。	デフォルト値は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のバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

Google形式からの変換について

Google形式からの変換は、対象のGoogle形式から判断して対応する形式へと変換されます。
対応するGoogle形式が存在しないファイルの読み取りを行った場合、読み取りに失敗します。
その場合、結果データのfile要素のstatus属性は「Error」になります。

読み取り可能なGoogle形式、および対応する変換後形式は以下の通りです。

Google形式	変換後形式
ドキュメント	ウェブページ(html)
プレゼンテーション	PDFドキュメント(pdf)
スプレッドシート	Microsoft Excel(xlsx)
図形描画	PNG画像(png)

仕様制限

Googleドライブでは同名ドライブ、同名ファイル、および同名フォルダが使用できますが、本アダプタでは対応していません。

DataSpiderファイルシステムの使用禁止文字を名前に含むフォルダ、またはファイルを扱うことはできません。
DataSpiderファイルシステムの使用禁止文字については、「DataSpiderファイルシステムの文字制約」を参照してください。

マイドライブ/共有ドライブに存在しないファイル/フォルダは参照できません。

Googleドライブの仕様変更、および本アダプタの仕様制限により、結果データのfile要素のetag属性は空白になります。

主な例外

例外名	原因	対策
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[]	[接続先]が指定されていません。	[接続先]を指定してください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]	[接続先]で選択されたリソース定義が見つかりません。	[接続先]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。

注意事項

Googleドライブと本アダプタとの通信は、HTTPSを使用します。

実行時に、接続関連以外のエラー(「主な例外」項に記載のないエラー)が発生した場合、エラーが発生したファイル/フォルダのfile要素のstatus属性に「Error」を設定して結果データとして出力し、後続の処理を続行します。

Googleドライブの空き容量が少なくなると、ファイル/フォルダの読み取りを正常に行うことができない場合があります。
その場合には、Googleドライブの空き容量を増やしてください。