はじめに
こんにちは。すぎもんです。
今回は HULFT Square の HULFT アプリケーションでアウトバウンドのファイル転送を行ってみた際の記事になります。
HULFT Square について紹介している公式サイトもあわせてご覧ください。
今回やること
『HULFT SquareからHULFTへのファイル転送』
以下の別記事との3部構成で、HULFT アプリケーションの動作についても検証してます。
- HULFT Square で HULFT アプリケーションのサービスを起動してみた
- HULFT アプリケーションでファイル転送をしてみた【インバウンド編】
- HULFT アプリケーションでファイル転送をしてみた【アウトバウンド編】★本記事★
それでは早速やってみましょう！
実施手順
以下の流れで HULFT アプリケーションのファイル転送を行っていきます。
① サービスの設定（HULFT Square）
② スクリプトの開発（HULFT Square）
③ 管理情報の登録（HULFT Square）
④ 管理情報の登録（HULFT8）
⑤ アプリケーションの作成（HULFT Square）
⑥ ファイル転送（HULFT Squareからの配信要求）
① サービスの設定
サービスの設定 については、以下の記事をご参照ください。
HULFT アプリケーションでファイル転送をしてみた【インバウンド編】
② スクリプトの開発
スクリプトの開発 は、下記の手順で行っていきます。
- プロジェクトの作成
- スクリプトの作成（配信）
1. プロジェクトの作成
プロジェクトの作成については、以下の記事をご参照ください。
HULFT アプリケーションでファイル転送をしてみた【インバウンド編】
2. スクリプトの作成（配信）
HULFT App サービスに対してファイルの配信要求を発行するスクリプトを開発します。
下記の スクリプト変数 を作成します。
- StatusCode
- SndFileName
- SndFileId
- SndFilePath
「スクリプト入力変数として使用する」にチェックを入れます。
[例外監視]アイコンを利用して[try]からの処理結果を監視し、例外が発生した場合は[catch]以降の処理を動作させます。
[マッピング] アイコンを利用して配信要求アイコンに必要な値をセットします。
転送定義セット は、以下のように設定を行います。
- 出力の [fileid]：スクリプト変数の[SndFileId]を設定
- 出力の[file_name]：配信ファイル名をフルパスで設定する必要があるため、スクリプト変数の[SendFilePath]と[SndFileName]を連結して設定
- スクリプト変数[SndFileId]：スクリプト変数の[SndFileName]を設定
[一括配信要求（動的設定）] アイコンを利用して配信要求を発行します。
[入力データ] には「転送定義セット」を指定します。
[繰り返し(条件指定)] アイコンを利用して配信結果が戻るまでループします。
スクリプト変数 [StatusCode] が ” ” と等しいという条件にします。
[待機処理] アイコンを利用して5秒待機します。
[待機時間] を 5秒に設定します。
[マッピング]アイコンを利用して転送結果確認アイコンに必要な値をセットします。
転送情報引渡 は、以下のように設定を行います。
- 出力の[file_id]：配信要求処理から戻るファイルIDを設定
- 出力の[execution_id]：配信要求処理から戻る実行IDを設定
[配信結果取得]アイコンを利用して配信結果を取得します。
[入力データ] には「転送情報引渡」を指定します。
[マッピング]アイコンを利用して転送結果確認アイコンからの結果をセットします。
転送結果変数セット は、以下のように設定を行います。
- 出力の[StatusCode]：転送結果確認処理から戻るステータスコードを設定します。
[条件分岐]アイコンを利用してファイル転送の成否をステータスコードにて判断します。
スクリプト変数[StatusCode]が”000000-00000”と等しくないという条件にします。
転送エラー判定にて配信がエラーであった時の処理を設定します。
${StatusCode}を設定します。
③ 管理情報の登録（HULFT Square）
管理情報の登録（HULFT Square） は、下記の手順で行っていきます。
- 詳細ホスト情報の作成
- 転送グループ情報の作成
- 配信管理情報の作成
1. 詳細ホスト情報の作成
詳細ホスト情報の作成については、以下の記事をご参照ください。
HULFT アプリケーションでファイル転送をしてみた【インバウンド編】
2. 転送グループ情報の作成
転送グループ情報の作成については、以下の記事をご参照ください。
HULFT アプリケーションでファイル転送をしてみた【インバウンド編】
3. 配信管理情報の作成
[メイン] > [HULFT App] > [配信管理情報] で、作成を行っていきます。
下記の内容を設定します。
- ファイルID：大文字で任意のファイルIDを設定します。
- 配信ファイル名：ストレージの配信ファイルを指定します。
- 転送グループID：先に設定しておいた転送グループを選択します。
④ 管理情報の登録（HULFT8）
管理情報の登録（HULFT8） は、下記の手順で行っていきます。
- 詳細ホスト情報の作成
- 集信管理情報の作成
1. 詳細ホスト情報の作成
詳細ホスト情報の作成については、以下の記事をご参照ください。
HULFT アプリケーションでファイル転送をしてみた【インバウンド編】
2. 集信管理情報の作成
対向先となるHULFTに集信管理情報を登録します。
POINT
集信ファイルIDは HULFT Square で作成した配信ファイルIDと同じものを指定します。
⑤ アプリケーションの作成
アプリケーションの作成は、下記の手順で行っていきます。
POINT
アプリケーション作成後に新しいトリガーを追加する場合や指定したスクリプトを変更する場合は、新しくアプリケーションを作成しなおします。
- クローンの作成
- コンフィギュア・デプロイ
1. クローンの作成
「クローンと編集」を選択します。
トリガー条件の「Transfer」は集信後のスクリプトを指定します。
各サービスとプロファイルを選択し、「ビルド」を押下します。
配信ファイルIDを選択し、「Test」を実行します。
成功したのを確認し、適用します。
これでアプリケーションの作成は完了です。
2. コンフィギュア・デプロイ
作成したアプリケーションでコンフィギュアを行っていきます。
該当のプロファイルを選択し、「コンフィギュア」を押下します。
サービスとプロファイルを選択します。
トリガ条件は、以下のように設定します。
- ファイルイベント：ファイルが作成された時
- 監視対象：ファイルを格納するフォルダ
- Event type：スクリプトでは利用しません。
- File name：対象のファイル名が「SndFileName」に渡るように設定します。
- File path：対象のファイルのパスが「SndFilePath」に渡るように設定します。
集信管理情報の取り込みを行います。
ファイルIDを選択し、前画面に戻ります。
以下のようにtransferトリガーのパラメータとスクリプト内に設定したスクリプト変数との紐づけを行います。
- ファイルID ： Transfer Name
- 詳細ホスト情報名：Host Info
- ステータスコード：Status Code
- 詳細コード ：Detail Code
- ファイル名 ：File Name
- ファイルサイズ ：File Size
- 開始時刻 ：Start Time
- 終了時刻 ：End Time
- msg0 ：msg0
- msg1 ：msg1
配信管理情報の取り込みを行います。
ファイルIDを選択し、前画面に戻ります。
「テスト」を実行して、成功したのを確認したら適用します。
コンフィギュアが成功したら、デブロイを行います。
「アンデプロイ」ボタンに変わればデプロイ成功です。
[メイン] > [ジョブ] > [アプリケーション] から起動していることが分かります。
⑥ ファイル転送の検証
配信用のストレージにファイルをアップロードします。
モニタリング画面から配信要求スクリプトが成功したことが分かります。
HULFT側の完了コードからも成功したことが分かります。
POINT
Windowws版HULFTのコンソールは、HULFT管理画面の[ツール]から表示します。
最後に
今回は HULFT アプリケーションでファイル転送を行ってみましたが、いかがでしたでしょうか。
今回は手動にてファイルアップロードを実行しましたが、特定ストレージに対するファイルトリガーを利用しています。前後の業務フローに応じて、業務スクリプト自体も作りこむことが可能ですので、皆さんも是非試してみてください！
このブログでは、今後も様々なTopics記事や接続検証等、皆さんの参考になるような記事を投稿していきたいと思います！
ここまで読んでいただきありがとうございました。それでは、また！