今回は@TovasアダプターのFAX送信指示とFAX送信指示の内容と結果の参照についてご紹介させていただきます。
@TovasDeliverFaxUploadコンポーネント、@TovasDetailDeliveryコンポーネントをフローで実際に使用してみます。
■事前準備
【@Tovas】
FAX番号だけでは送信先が判別しづらいため、@Tovasに送信先の会社名と担当者の設定を行えるようにします。
下記の手順に従って、@Tovasの任意に設定できる自由項目の設定を行います。
- @Tovas統合管理センターに管理者でログインしてください。
- メニューから [管理] -> [機能設定] を選択します。
- 自由項目設定参照画面から自由項目の [利用者] を選択します。
- 自由項目設定変更画面から下記のように設定して [保存] ボタンをクリックします。
- 連携方式：「API」を選択します
- 自由項目1：入力形式に「テキスト」を選択して、名称に会社名を設定します
- 自由項目2：入力形式に「テキスト」を選択して、名称に担当者を設定します
■FAX送信指示
FAX送信情報のCSVファイルとFAX送信するPDFファイルを用意します。
用意したCSVファイルを読み込んで、@TovasDeliverFaxUploadコンポーネントでFAXの送信指示を行ってみます。
・CSVファイルの内容
送信ファイルパスに用意したPDFファイルの配置場所を設定します。
また、会社名と担当者は事前準備で設定した自由項目に設定します。
・フローの構成
- RecordGetコンポーネントを配置します。
- Mapperコンポーネントを配置します。
- @TovasDeliverFaxUploadコンポーネントを配置します。
- Mapperコンポーネントを配置します。
送信情報CSVファイルを読み込みの設定
- RecordGetコンポーネントのプロパティに用意しておいたCSVファイルの設定を行います。
- RecordGetコンポーネントの出力ストリームに用意しておいたCSVファイルのフィールド定義の設定を行います。
送信ファイルをアップロードしてFAX送信指示の設定
- @TovasDeliverFaxUploadコンポーネントのコネクション名プロパティに作成しておいた@Tovasコネクション名を指定します。
- @TovasDeliverFaxUploadコンポーネントの自由項目の設定プロパティを「する」に変更します。
CSVファイルの項目をマッピングの設定
- CSVファイル項目のFAX番号を@TovasDeliverFaxUploadコンポーネントのFAX番号プロパティにマッピングをします。
- CSVファイル項目の件名を@TovasDeliverFaxUploadコンポーネントの件名プロパティにマッピングをします。
- CSVファイル項目の送信ファイルパスを@TovasDeliverFaxUploadコンポーネントのFilePathストリームにマッピングをします。
- CSVファイル項目の会社名を@TovasDeliverFaxUploadコンポーネントの自由項目の項目１プロパティにマッピングをします。
- CSVファイル項目の担当者を@TovasDeliverFaxUploadコンポーネントの自由項目の項目２プロパティにマッピングをします。
送信指示を識別するための送信IDをマッピングの設定
- @TovasDeliverFaxUploadコンポーネントのストリーム変数からDeliveryID（送信ID）を戻り値にマッピングをします。
・フローの実行結果を確認
@Tovas統合管理センターに利用者でログインしてからメニューから [送信履歴] -> [送信BOX] を選択すると一覧画面にFAX送信の指示が登録されているのが確認できます。
@Tovasの一覧画面から登録された情報を選択すると詳細画面に登録した内容が表示されます。
■フローの実行結果でエラーが発生した場合
FAX送信指示等を実行して下記のようにエラーが発生した場合にエラー内容をログに出力してみます。
・フローの実行結果を確認
・エラーフローの構成
- Mapperコンポーネントを配置します。
- Logコンポーネントを配置します。
Startコンポーネントの設定
- 出力ストリーム型に「XML」を選択します。
- 名前空間を定義します。PrefixにSOAP-ENV、URIにhttp://schemas.xmlsoap.org/soap/envelope/を設定します。
- XMLのフィールド名を定義します。（コンポーネントのヘルプを参照）
エラー内容のマッピングの設定
- Embed関数を設定します。
- Embed関数の出力をLogコンポーネントの出力メッセージにマッピングします。
・フローの構成
送信ファイルをアップロードしてFAX送信指示の設定
- @TovasDeliverFaxUploadコンポーネントのSOAPフォルトプロパティに作成したエラーフロー（SoapFault）を指定します。
・フローの実行結果を確認
LogコンポーネントでFlowServiceログに出力された内容
■FAX送信指示の内容と結果の参照
FAX送信指示を実行した結果のCSVファイルを用意します。
用意したCSVファイルを読み込んで、@TovasDetailDeliveryコンポーネントを使用してFAX送信指示を行った情報を参照してみます。
・CSVファイルの内容
送信IDはFAX送信指示を識別するためのDeliveryID（送信ID）を設定します。
・フローの構成
- RecordGetコンポーネントを配置します。
- Mapperコンポーネントを配置します。
- @TovasDetailDeliveryコンポーネントを配置します。
- Mapperコンポーネントを配置します。
送信結果のCSVファイルを読み込みの設定
- RecordGetコンポーネントのプロパティに用意しておいたCSVファイルの設定を行います。
- RecordGetコンポーネントの出力ストリームに用意しておいたCSVファイルのフィールド定義の設定を行います。
FAX送信指示の情報を参照の設定
- @TovasDetailDeliveryコンポーネントのコネクション名プロパティに作成しておいた@Tovasコネクション名を指定します。
CSVファイルの項目のマッピング
- CSVファイル項目の送信IDを@TovasDetailDeliveryコンポーネントの送信IDプロパティにマッピングをします。
送信明細情報の送信状態をマッピング
- @TovasDetailDeliveryコンポーネントの出力ストリームから送信状態を戻り値にマッピングをします。
・フローの実行結果を確認
■最後に
FAX送信指示（@TovasDeliverFaxUploadコンポーネント）、FAX送信指示の情報を参照（@TovasDetailDeliveryコンポーネント）の紹介はここまでです。
また、ファイル送信指示（@TovasDeliverFileUploadコンポーネント）、ファイル送信指示の情報を参照（@TovasDetailDeliveryFileコンポーネント、@TovasDetailRoundTripコンポーネント）に関しましても同様となります。