AzureBlobGet

AzureBlobGet - AzureBlobからの入力

Windows AzureストレージからコンテナのBlob/ Blobリストを取得します。

■ストリーム情報

入力	フォーマット	すべて
	接続数	無制限
	説明	入力ストリームは使用せず、すべて無視します。
出力	フォーマット	すべて

出力ストリーム変数

名前	データ型	説明
Name	String	Blob名
Size	Integer	サイズ
ContentType	String	コンテントタイプ

■コンポーネントプロパティ

名前

プロパティ型

マッピング

説明

コネクションを使用

boolean

接続情報に以下のコネクション名を使用するかどうか選択します。

はい [true]	-	以下のコネクション名で指定した接続情報を使用します。
いいえ [false]	-	コネクション情報以下のプロパティを使って接続を行います。

コネクション名

connection

入力＆出力

接続先のAzureを指定します。コネクションペインまたは管理コンソールにて作成された汎用接続名を選択します。

コネクション情報

group

コネクションを使用が「いいえ」の場合に使用されるプロパティ群です。

アカウント名

string

入力＆出力

Azure のアカウント名を指定します。

共有キー

string

入力＆出力

認証用の共有キーを指定します。

プロトコル

choice

通信にHTTPまたはHTTPSであるかを指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。

HTTP [http]	-	HTTP通信場合
HTTPS [https]	-	HTTPS通信場合

タイムアウト(秒)

int

入力＆出力

リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。

プロキシー設定を使用

boolean

管理コンソールで設定したプロキシー設定を使用するかどうかを指定します。
コネクションを使用が「いいえ」の場合にこの設定が参照されます。

はい [true]	-	プロキシー設定を使用します。
いいえ [false]	-	プロキシー設定を使用しません。

接続ホスト

string

入力＆出力

接続先を指定したいときに指定します。デフォルトは <protcol>:<account name>.(blob|queue|table).core.windows.net になります。

コンテナ名

string

入力＆出力

コンテナ名を指定します。

Blob名

string

入力＆出力

Blob名を指定します。
"^$[]*+?|()"の文字を含む場合は、正規表現でBlob名が一致したものを取得します。
※ 日本語、中国語等マルチバイト文字は使用できないので、URLエンコード等で変換をしてください。

Prefix

string

入力＆出力

コンテナ内のBlobを接頭辞一致で取得する場合に使用します。
Blob名で正規表現している場合は、接頭辞一致した結果に対して正規表現の評価を実施します。
注意Prefixを指定した場合は、Blob名の値は正規表現記述の場合のみ使用します。

最大取得件数

int

入力＆出力

取得する件数の最大値を指定します。
0以下の値の場合は検索時最大件数は設定しません。

ループを開始

loopProcess

Blob名にワイルドカードが指定され、複数のBlobが指定にマッチする場合にBlobをまとめて出力するか1ファイルずつループして出力するかを選択します。

はい [true]	-	ループの起点となって1Blobずつストリームに出力します。
いいえ [false]	-	すべてのBlobをコンテナ化してまとめてストリームに出力します。

コミット時の処理

choice

コミット時に取得したBlobを削除するかどうかを選択します。

Blobを削除 [true]	-	削除します。
何もしない [false]	-	何もしません。

Blobが無い場合エラー

boolean

結果セットのレコード件数が0件だった場合にエラーを発生するかどうかを選択します。

はい [true]	-	エラーを発生します。
いいえ [false]	-	空のストリームを出力します。

メタデータ

■ループ処理

Blob名にマッチするBlobが複数あり、ループを開始が「はい」の場合、このコンポーネントがループの起点となってBlobを1つずつ出力します。

■トランザクション処理

コミット	コミット時の処理が「Blobを削除」の場合にBlobを削除します。
ロールバック	何もしません。

■エラー処理

タイプ	パラメータ	エラー処理フローへのストリーム	エラーコード	説明
汎用	なし	コンポーネントの入力ストリーム	なし
接続エラー	なし	コンポーネントの入力ストリーム	1	Azureとの接続に失敗した場合
Blobが無い	なし	コンポーネントの入力ストリーム	2	Blobが無い場合エラーが「はい」の場合で、レコードが0件の場合
REST API 共通エラー	なし	コンポーネントの入力ストリーム	エラーコード	CODE [%1] MESSAGE [%2] DETAIL [%3] API共通エラーになります。 %1:エラーコード %2:メッセージ %3: 詳細メッセージの内容
REST API Blobエラー	なし	コンポーネントの入力ストリーム	エラーコード	CODE [%1] MESSAGE [%2] DETAIL [%3] API Blobエラーになります。 %1:エラーコード %2:メッセージ %3: 詳細メッセージの内容

■コネクション設定

コンポーネントを使用するためにはあらかじめ汎用コネクションに接続用の設定をしておく必要があります。コネクション設定では以下のパラメータを定義します。

パラメータ名	設定内容	必須
accountName	アカウント名を指定します。 URLは通常 http://{アカウント名}.(blob\|queue\|table).core.microsoft.net/ です。	はい
sharedKey	共有キーを指定します。 Azureのドキュメントを参照してください。	はい
protocol	HTTPまたはHTTPSを指定します。値を解釈出来ない場合は、HTTPプロトコルを使用します。	いいえ省略時は、HTTPプロトコルを使用します。
timeout	タイムアウト時間を指定します。単位は秒です。0の時は無限のタイムアウトになります。	いいえ省略時は、0を指定します。
useProxy	FSMCで設定したプロキシーサーバを使用する場合「true」を指定します。プロキシサーバを使用しない場合は設定不要です。	いいえ
host	接続ホスト名を指定したい場合に指定します。この値で「http(s)://」を記述しない場合はprotcolの値を適用します。例： <ホスト名>/<通信時のパス> この値で「http(s)://」を記述した場合はこのプロトコルが優先され、protcolの値は無視します。例： http://<ホスト名>/<通信時のパス>	いいえ

■メタデータについて

コンポーネントで設定したメタデータの値は UTF-8 でURLエンコードしてあるので、外部のシステムで参照する場合は UTF-8でURLデコードしてください。

■正規表現を使用した場合のBlobの取得

正規表現を使用した場合の取得方法は、指定コンテナのBlobのリストを取得し、Blob名前が正規表現に一致したものを名前順にソートしたリストにします。ソートしたBlob名リスト順にBlobを取得していきます。

■ストレージブラウザの使い方

本コンポーネントをダブルクリックすると接続情報を使用してストレージブラウザを起動します。

画面構成

Container

キュー

テーブル

コンテナの一覧を表示します

キューの一覧を表示します

テーブルの一覧を表示します

コンテナ、キュー、テーブル共通操作
-	再検索	:	一覧を再検索します
-	詳細検索	:	接頭辞または検索クエリを指定して検索できます
-	新規作成	:	新規にコンテナ、キュー、テーブルを作成します
行操作
-	内容表示	:	選択した項目の内容をコンテンツリストに表示します
-	削除	:	選択した項目のコンテナ、キュー、テーブルを削除します
-	コンポーネントに設定	:	選択した項目の内容をコンポーネントに設定します
コンテナ操作
-	アクセスコントール	:	コンテナのアクセスコントロールレベルの設定をします設定後、即時に反映されない時があります

コンテンツリスト

コンテンツ内容

コンテナ、キュー、テーブル一覧選択行の内容を一覧表示します。

-	内容表示	:	選択した項目の内容をコンテンツ内容に表示します
-	削除	:	選択した項目のコンテンツを削除します
-	コンポーネントに設定	:	選択した項目の内容をコンポーネントに設定します

コンテンツリストで選択したものを表示します