SOAP Webサービスへのステータス送信を準備する
- アプリケーションのSOAP Webサービスとの通信要件を確認します。
- アプリケーションでの認証のための値
- SOAP Webサービスにデータを要求するための値
- 応答で提供されるデータ形式
アプリケーションの使用説明書を参照するか、アプリケーションをホストしている会社にお問い合わせください。
- RICOH ProcessDirectorで、アプリケーションとの通信を準備するには、以下のタスクを実行してください。
- アプリケーションにセキュリティー証明書が必要な場合は、RICOH ProcessDirectorの1次コンピューターに証明書をインストールします。
- 環境内でプロキシサーバーがWebサービスと通信する必要がある場合は、プロキシを使用するようにシステムをセットアップします。
- 呼び出す予定のWebサービスすべてのWSDLファイルをインポートします。
RICOH ProcessDirectorは、WSDLファイル内のSOAP操作からSOAP要求オブジェクトを作成します。RICOH ProcessDirectorがオブジェクトを作成するときに、SOAP操作の名前に追加する接頭部を指定します。SOAP要求オブジェクトは、Webサービスへの正しい呼び出しの作成に必要なSOAPバージョンなどの情報の判断を RICOH ProcessDirectorに任せます。
詳しくは、関連タスクを参照してください。
- アプリケーションで認証してSOAP Webサービスに応答を要求する手動テストを実行します。Webサービスが予期した応答を返すことを確認します。多くのブラウザーには、Boomerang for Google Chromeなど、テストWebサービスがSOAPクライアントに対して呼び出すプラグインがあります。
- 通知をトリガーするイベントを決定し、さらに通知でWebサービスを呼び出すタイミングを決める条件を設定します。特定のワークフローがジョブを処理するときにのみ発生するイベントの通知を送信する場合は、そのワークフローを条件として指定します。
- SOAP Webサービスの通知を定義するには、以下の手順に従ってください。
- 管理タブをクリックします。
- 左のペインでをクリックします。
- をクリックします。
- 一般タブで、通知の名前を入力します。
- 要求タブでの操作:
- 要求URLプロパティーに、通知するWebサービスのURLを設定します。
- 要求ペイロードプロパティー値の場合は、通知がアプリケーションに送信するWebサービス要求の本文を指定します。この例では、ペイロードに次の2つのXMLエレメントが含まれます。<Token>および<OrderNumber>。
<Token>${WS.Notification.WebService.Credential}</Token> <OrderNumber>${Job.Info.Attr1}</OrderNumber>
各エレメントの値は、プロパティーを含む RICOH ProcessDirectorシンボルです。アプリケーションでの認証のためにWebサービスを使用している場合は、シンボルに WSNotification.WebService.Credentialプロパティーを含めます。その他のエレメントとプロパティーを、アプリケーションに送信するエレメントとプロパティーで置き換えます。通知は、SOAP Webサービスにステータスを送信するときにシンボルを解決します。
- SOAP要求プロパティーに、WSDLファイルのインポート時に RICOH ProcessDirectorが作成した SOAP要求を設定します。例えば、CloseoutOrderByNumberSOAP要求を使用すると仮定します。インポート時には、SOAP要求の名前の先頭に PrintShopを追加しました。 PrintShop-CloseoutOrderByNumberを選択します。
- 環境内でプロキシサーバーがWebサービスと通信する必要がある場合は、プロキシを使用プロパティーに正しいプロキシサーバーを設定します。
- 認証タブで、アプリケーションによる認証に必要な値を指定します。詳しくは、SOAP Webサービスでの認証の関連タスクを参照してください。
アプリケーションで認証が要求されない場合は、［認証］プロパティーをすべて空白のままにします。
- イベントタブで、次の操作を実行します。
- 監視するオブジェクトのタイプを選択します。
- 監視するプロパティー、アクションおよび値を選択します。
- 別のイベントを定義するには、任意のイベントの右側にある+をクリックします。
- イベントを削除するには、削除するイベントの右側の-をクリックします。
例えば、ジョブの状態が保存に変更されたときに通知を送信するには、 現行ジョブの状態、 変更後および 保存を選択します。 - 条件タブで、次の操作を実行します。
- 通知が送信される前に満たす必要があるプロパティーおよび値を選択します。
- 別の条件を定義するには、任意のイベントの右側にある+をクリックします。条件の組み合わせ方法を指定するには、任意、 すべて、または カスタムを選択します。
- 条件を削除するには、削除する条件の右側の-をクリックします。
例えば、子ジョブがProcessWebOrdersワークフローに組み込まれている場合にのみ通知を送信するには、次の2つの条件を指定します。- Workflow = ProcessWebOrders
- Job number like*.*
ジョブが両方の条件を満たした場合にのみ条件を適用するには、すべてを選択します。
- 完了したら、OKをクリックします。
入力装置、通知、およびワークフローのセットアップが完了したら、RICOH ProcessDirector とアプリケーションの間でデータの交換をテストします。
付属のRestfulWebServiceSampleNorifyREST Webサービスの通知は、SOAP Webサービスの通知に似ています。MarcomCentral Connect機能には、付属のSOAP Webサービスの通知が含まれています。