MarcomCentral Web サービスの呼び出しを準備する

この手順では、WSDL ファイルをインポートし、セキュリティー証明書をインストールします。使用している環境で、MarcomCentral との通信にプロキシサーバーが必要な場合は、このサーバーを使用するようにシステムをセットアップします。サンプルの入力装置、ワークフロー、および通知から呼び出される操作の他に、MarcomCentral Web サービスで呼び出す必要のある操作があるかどうかを判断します。呼び出す必要がある場合は、その操作の要件を調べ、手動で Web サービスをテストします。
MarcomCentral Web サービスの呼び出しを準備するには:
  1. MarcomCentral Web サービスを呼び出す前に、次のタスクを実行します。
    1. 呼び出す予定のある MarcomCentral Web サービスごとに WSDL ファイルを 1 つインポートします。

      RICOH ProcessDirectorは、WSDLファイル内のSOAP操作からSOAP要求オブジェクトを作成します。RICOH ProcessDirectorがオブジェクトを作成するときに、SOAP操作の名前に追加する接頭部を指定します。SOAP要求オブジェクトは、Webサービスへの正しい呼び出しの作成に必要なSOAPバージョンなどの情報の判断を RICOH ProcessDirectorに任せます。

    2. RICOH ProcessDirector プライマリコンピューターに MarcomCentral のセキュリティー証明書をインストールします。
    3. 使用している環境で、MarcomCentral との通信にプロキシサーバーが必要な場合は、このサーバーを使用するようにシステムをセットアップします。
    詳しくは、関連タスクを参照してください。
  2. 実動 MarcomCentral ストアをお持ちの場合は、テストストアをセットアップすることをお勧めします。

    テストストアがあれば、誤って本物の注文を処理することなく、入力装置、CallSOAPServiceステップ、および通知をテストできます。RICOH ProcessDirector と MarcomCentral の間に、単純な注文と基本的なプロセスを処理するための通信を確立できます。Web サービス呼び出しに徐々に情報を追加しながら、新しい Web サービス呼び出しをテストします。

  3. MarcomCentral Connect 機能のサンプルオブジェクトにより呼び出される操作の他に、MarcomCentral Web サービスで呼び出す必要のある操作があるかどうかを判断します。

    サンプルオブジェクトは、MarcomCentral Web サービスでこれらの操作を呼び出します。

    • サンプルのMarcomReceiveOrders入力装置は、 注文Web サービスの GetOrdersByDate操作を呼び出し、指定された期間内の注文を取得します。

    • サンプルのMarcomProcessOrdersワークフローにある CallSOAPServiceステップは、 ジョブチケットWeb サービスの GetJobTicketsByOrderNumber操作を呼び出し、注文のジョブチケットをすべて取得します。

    • サンプルのMarcomProcessJobTicketワークフローにある CallSOAPServiceステップは、 ジョブチケットWeb サービスの GetJobTicketByLineItem操作を呼び出し、ダウンロードするファイルの URL を取得します。

    • サンプルのMarcomCloseoutOrder通知は、 注文完了Web サービスの CloseoutByOrder操作を呼び出し、完了した注文の注文 ID を送信します。

      請求書、内容明細書、精算書に必要な情報を、通知の要求ペイロードプロパティーに追加できます。また、 請求書内容明細書精算Web サービスを呼び出して、請求書、内容明細書、精算の各操作を個別に行うこともできます。詳しくは、MarcomCentral Web サービスの資料を参照してください。

    カタログインベントリーなど、どのような MarcomCentral Web サービスのどのような操作でも、 CallSOAPServiceステップまたは SOAP Web サービスの通知から呼び出すことができます。

  4. MarcomCentral の注文およびジョブチケットを処理する RICOH ProcessDirector ワークフローから MarcomCentral Web サービスの別の操作を呼び出すには:
    1. MarcomCentral Web サービスオペレーションとの通信の要件を調べます。

      • 要求するデータの値

      • 応答で提供されるデータ形式

      Web サービスの MarcomCentral の資料を参照するか、同社にお問い合わせください。

    2. MarcomCentral との認証、および Web サービスへの応答要求を手動でテストします。Web サービスで必要な処理が行われたことを確認します。

      多くのブラウザーには、Boomerang for Google Chromeなど、テストWebサービスがSOAPクライアントに対して呼び出すプラグインがあります。

      テスト呼び出しにより、ストアが正しく更新されて、正しい応答が返されれば、ペイロードを RICOH ProcessDirector で使用する準備は完了です。

    3. ペイロードをテキストファイルに保存します。
    4. この呼び出しをCallSOAPServiceステップの Web サービスオペレーションに入れるには、注文またはジョブチケットの処理ワークフローを定義するときに、このステップを追加します。このペイロードを、 CallSOAPServiceステップの 要求ペイロードプロパティーにコピーします。
    5. この呼び出しを通知の Web サービスオペレーションに入れるには、注文またはジョブチケットの処理ワークフローを定義した後で、この通知を追加します。このペイロードを、通知の要求ペイロードプロパティーにコピーします。

MarcomCentral Web サービスを呼び出す準備が完了したら、MarcomCentral から注文を取得する準備は完了です。