ファイル/フォルダ一覧取得処理

オペレーション名

ファイル/フォルダ一覧取得

機能概要

ニフティクラウドストレージ上にあるファイル/フォルダの一覧を取得します。

データモデル

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

プロパティ

変数の使用については、「変数」を参照してください。
基本設定
項目名 必須/省略可 変数の使用 説明 備考
名前 必須 使用不可 スクリプトキャンバス上での名前を入力します。  
必須設定
項目名 必須/省略可 変数の使用 説明 備考
接続先 必須 使用不可 グローバルリソースを選択します。
  • [追加]:
    新規にグローバルリソースを追加します。
  • [一覧の編集]:
    「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
 
バケット名 必須 使用可 バケットを指定します。
  • [バケット名]に大量のファイルが存在するバケットを指定した場合、[フォルダパス]のリストの更新に時間がかかることがあります。
    回避方法については、「注意事項」を参照してください。
フォルダパス 必須 使用可 ニフティクラウドストレージのフォルダパスを入力します。
再帰的に処理する 省略可 使用不可 指定したフォルダについて、再帰的に一覧を取得するかどうかを選択します。
  • [チェックあり]:
    指定したフォルダにフォルダが含まれる場合、再帰的に一覧を取得します。
  • [チェックなし]:(デフォルト)
    指定したフォルダのみ一覧を取得します。
 
アクセス権の情報を結果に含める 省略可 使用不可 ファイルのアクセス権の情報を結果に含めるかどうかを選択します。
  • [チェックあり]:
    ファイルのアクセス権の情報を結果に含めます。
  • [チェックなし]:(デフォルト)
    ファイルのアクセス権の情報を結果に含めません。
 
データ処理方式
項目名 必須/省略可 変数の使用 説明 備考
データ処理方式 必須 使用不可 データ処理方式を選択します。
  • [スクリプトの設定を使用する]:(デフォルト)
    スクリプトプロパティの大容量データ処理の設定をアダプタに使用します。
  • [大容量データ処理を行わない]:
    大容量データ処理を行いません。
  • [大容量データ処理を行う]:
    大容量データ処理を行います。
 
コメント
項目名 必須/省略可 変数の使用 説明 備考
コメント 省略可 使用不可 このアダプタの簡単な説明を記述することができます。
説明を記述すると、仕様書に反映させることができます。
 

スキーマ

入力スキーマ

ありません。

出力スキーマ

<?xml version="1.0"?>
<server>
  <bucket errorcode="" name="" status="" >
    <file errorcode="" etag="" name="" public="" remotepath="" size="" status="" type="" updated="" />
  </bucket>
</server>
<
要素名 属性名 説明 備考
server -    
bucket - 取得したバケットごとに出現します。  
errorcode バケット取得時にニフティクラウドストレージでエラーが発生した場合、ニフティクラウドストレージで定義されているAPIエラーコードを出力します。
  • ニフティクラウドストレージでエラーが発生しない場合空白になります。
  • ニフティクラウドストレージで定義されているAPIエラーコードについては、(http://cloud.nifty.com/api/storage/errorcode.htm)を参照してください。
name 取得したバケットの名前を出力します。  
status 取得したバケットの状態を出力します。
  • Exist:バケットが存在している状態です。
  • ErrorBucketNotFound:指定した[バケット]がニフティクラウドストレージ上に存在しない状態です。指定したバケット名が誤っている可能性があります。
  • Error:エラーが発生したため、バケットの取得ができなかった状態です。
 
file - 取得したファイル/フォルダごとに出現します。  
errorcode ファイル/フォルダ削除時にニフティクラウドストレージでエラーが発生した場合、ニフティクラウドストレージで定義されているAPIエラーコードを出力します。
  • ニフティクラウドストレージでエラーが発生しない場合空白になります。
  • ニフティクラウドストレージで定義されているAPIエラーコードについては、(http://cloud.nifty.com/api/storage/errorcode.htm)を参照してください。
etag 取得したファイル/フォルダのETagを出力します。
  • ファイル/フォルダの情報が正常に取得できなかった場合は値が空白になります。
name 取得したファイル/フォルダの名前を出力します。
  • statusが「ErrorRemoteFolderNotFound」の場合は値が空白になります。
public 取得したファイル/フォルダのアクセス権を出力します。
  • true:公開
  • false:非公開
  • ファイル/フォルダの情報が正常に取得できなかった場合は値が空白になります。
  • 「認証ユーザー」または「未認証ユーザー」に「READ」権限が付与されている場合に、「公開」としています。
  • [アクセス権の情報を結果に含める][チェックなし]の場合は値が空白になります。
remotepath 取得したファイル/フォルダのニフティクラウドストレージ上のファイルパスを出力します。  
size 取得したファイル/フォルダのサイズを出力します。単位はバイトです。
  • ファイル/フォルダの情報が正常に取得できなかった場合は値が空白になります。
  • フォルダの場合は常に「0」が出力されます。
status 取得したファイル/フォルダの状態を出力します。
  • Exist:ファイル/フォルダが存在している状態です。
  • ErrorRemoteFolderNotFound:指定した[フォルダパス]がニフティクラウドストレージ上に存在しない、またはファイルを指定した状態です。
  • 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のバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

仕様制限

ありません。

主な例外

例外名 原因 対策
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[]
[接続先]が指定されていません。 [接続先]を指定してください。
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]
[接続先]で選択されたリソース定義が見つかりません。 [接続先]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException
<プロパティ名>が指定されていません。
[<プロパティ名>]が指定されていません。 [<プロパティ名>]を指定してください。
com.nifty.cloud.ncs.service.StorageException
The Access Key Id you provided does not exist in our records.
[接続先]で指定したグローバルリソースの[AccessKey]に誤りがあります。 [接続先]で指定したグローバルリソースの設定を確認してください。
com.nifty.cloud.ncs.service.StorageException
The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. For more information, see REST Authentication and SOAP Authentication for details.
[接続先]で指定したグローバルリソースの[SecretAccessKey]に誤りがあります。 [接続先]で指定したグローバルリソースの設定を確認してください。
com.nifty.cloud.ncs.NiftyCloudClientException
Failed to execute HTTP request: Connect to ncss.nifty.com/ncss.nifty.com/xxx.xxx.xxx.xxx timed out
[接続先]で指定したグローバルリソースの[タイムアウト]の間に、ニフティクラウドストレージとの接続が確認できませんでした。 [接続先]で指定したグローバルリソースの設定を確認してください。
com.nifty.cloud.ncs.NiftyCloudClientException
Failed to execute HTTP request: peer not authenticated
[接続先]で指定したグローバルリソースの[タイムアウト]の間に、ニフティクラウドストレージの認証が確認できませんでした。 [接続先]で指定したグローバルリソースの設定を確認してください。

注意事項