ワークフローに機能を追加する

RICOH ProcessDirectorワークフローを構成して、印刷ジョブを他のアプリケーションに送って追加処理し、それをシステムに送り返すようにできます。他のアプリケーションは、1次サーバーと同じサーバー上、2次サーバー上、またはアプリケーションサーバー上で実行できます。

アプリケーションが提供する処理が印刷ワークフローに組み込み可能な場合（アドレスのクリアや組み付けなど）、RICOH ProcessDirectorからアプリケーションに印刷ジョブを送り、アプリケーションの完了を待機し、RICOH ProcessDirectorで処理を続行するためのステップを作成できます。RICOH ProcessDirectorの使用説明書では、これらのステップを外部ステップと呼びます。

条件付きワークフローでは、外部ステップは複数のステップから入力を受け取り、その入力に基づいて異なるプログラムを実行します。PDFProductionサンプルワークフローでは、外部ステップはジョブのページ数に基づいて異なるプロパティーを受け取ります。外部ステップは、複数の場所に結果を書き込み、複数のステップに出力を送ることができます。例えば、外部ステップは、外部プログラムによって計算された値に基づいて、3つの異なるステップにジョブを送ることができます。外部ステップは条件付きワークフローの分岐を終了できます。

RICOH ProcessDirectorには、外部ステップに対するさまざまなステップテンプレートが含まれています。

  • RunExternalProgram

    コマンド行インターフェースを使用して印刷ジョブを外部プログラムに実行依頼します。

  • RunHotFolderApplication

    他のアプリケーションが監視しているホットフォルダーに印刷ジョブを配置します。そのアプリケーションは、印刷ジョブを取得し、その構成設定に従って処理し、出力フォルダーに配置します。RICOH ProcessDirectorは、出力フォルダーを監視し、準備ができたらジョブを取得します。

どのステップテンプレートを使用するかの選択は、第1に外部アプリケーションがジョブを受け入れる方法に依存します。アプリケーションがコマンド行インターフェースの場合、ワークフローはRunExternalProgramを組み込めます。アプリケーションが入力のホットフォルダーを監視している場合は、ワークフローはRunHotFolderApplicationを組み込めます。アプリケーションに両方のインターフェースがある場合は、使用するステップを自分で決めることができます。

RICOH ProcessDirectorは、外部プログラムと統合されるオプション機能を提供します。これらの機能には、ユーザーが使用できる追加のステップテンプレートが含まれています。

  • Quadient Inspire接続

    • ComposePDF

      Quadient Inspire Designerを使用して、WFDファイルと1つ以上のRAWデータファイルから新しいPDFファイルを作成します。このステップは、新しいファイルが返されるまで待機します。

    • ComposeAFP

      Quadient Inspire Designerを使用して、WFDファイルと1つ以上のRAWデータファイルから新しいAFPファイルを作成します。このステップは、新しいファイルが返されるまで待機します。ComposeAFPは、Quadient Inspire接続機能およびAFP Support機能がインストールされている場合に使用可能になります。

  • MarcomCentral Connect

    • ApplyXSLTransform

      MarcomCentral形式の情報をRICOH ProcessDirectorジョブプロパティーに変換します。

    • CallSOAPService

      MarcomCentralジョブチケットWebサービスを呼び出して、各注文のジョブチケットを取得します。

    • CreateJobsFromXML

      MarcomCentral Webサービスによって返された情報を使用して、各ジョブチケットのジョブを作成します。このステップは、MarcomProcessJobTicketワークフローにジョブを実行依頼します。

  • Pitstop接続

    • RunPitStopOnJob

      アクションリストまたはPDFプロファイルとともにPDF印刷ジョブをPitStop Serverに実行依頼します。RICOH ProcessDirectorは、PitStop Serverがジョブを処理し、返すのを待ってから、ワークフローの次のステップに進みます。

  • Postal Enablement

    • SetPostalJobProps

      郵便ソフトウェアで必要なジョブプロパティーを設定し、外部文書プロパティーファイルに含まれる郵便物情報をどのように処理するかを決定できます。

    • BuildExternalDocPropsFile

      文書プロパティーファイルから文書データを抽出して、外部プログラムに送信する必要のある文書データと見出しを含むファイルを作成できます。作成したファイルは、外部文書プロパティーファイルと呼ばれます。

    • MapExternalResultsFiletoDocProps

      外部結果ファイルから選択した文書プロパティーを変更済み結果ファイルに含まれる文書プロパティーにマッピングします。外部結果ファイルは、外部プログラムによって作成されます。

    • UpdateDocPropsFromExternalResultsFile

      変更済み結果ファイル内のプロパティーは、ジョブの文書プロパティーファイルにマージされます。

  • Ultimate Impostrip® Connect

    • RunImpostripOnJob

      正しく構成されている場合、ジョブで適切な面付け機能を実行するように設定されたUltimate Impostrip®入力ホットフォルダーに、PDF印刷ジョブを実行依頼します。RICOH ProcessDirectorは、Ultimate Impostrip®サーバーが更新されたジョブを返すのを待ってから、ワークフローの次のステップによる処理に進みます。

使用するステップを決めるときには、次のことを考慮します。

  • RunExternalProgram
    • コマンドを記述して必要なオプションをすべて指定する必要があります。アプリケーションを実行するためのコマンド記述に慣れていない場合や、コマンドの構文がわからない場合、このステップを利用すると構成が困難になります。
      注意: 外部プログラムがstdoutまたはstderrorに書き込んだすべての出力は、RICOH ProcessDirectorジョブログに表示されます。stdoutにすべての出力を書き込むプログラムやシステムコマンドを実行するコマンドを使用する場合、出力を別の場所にリダイレクトできるように、外部プログラムを呼び出すスクリプトを使用することをお勧めします。
    • 他のアプリケーションに送られるコードページと言語を指定できます。
    • 印刷ジョブをエラーにすることなくプログラムが提供できる戻りコードを指定できます。
    • 外部アプリケーションが使用できる処理パラメーター（プログラムが受け入れる場合）が含まれる、制御ファイルを使用できます。
  • RunHotFolderApplication
    • 他のアプリケーションに1つ以上のファイルを送信できます。
    • 送信フォルダーおよび検索フォルダーを正しく構成する必要があります。送信するファイルのファイル名が検索パターンに一致しない限り、送信フォルダーと検索フォルダーを同じにできます。検索パターンは、返されたジョブを特定するためのパターンマッチング文字列です。

      例えば、外部アプリケーションがファイルをPostScriptからPDFに変換する場合は、検索パターンで拡張子.PDFのファイルが検索されます。ステップはprintfile.psをディレクトリーにコピーしますが、検索パターンはprintfile.PDFを検索するため、コピーされたファイルが変換済みファイルと混同されることはありません。

      しかし、プリフライトアプリケーションにPDFファイルを送信するためにホットフォルダーを使用すると、そのアプリケーションは別のPDFファイルを送り返すため、同じ名前になる可能性があります。その場合は、送信フォルダーと検索フォルダーを別の場所にする必要があります。

    • 有効な戻りコードを指定するためのオプションは、ありません。

      外部アプリケーションが予期されたファイルを返した場合、ステップはファイルを取得して、エラーをチェックしないで次のステップに処理を移動します。その結果、エラーがあるファイルを出力ディレクトリーにコピーしないように、他のアプリケーションを構成する必要があります。ホットフォルダーがタイムアウトするように設定されている場合、ジョブは最終的にはエラー状態になって問題を解決することがます。ホットフォルダーが無期限に待機するように構成されている場合、ジョブはオペレーターが介入するまで待機し続けます。

一部の環境では、ステップが連携するように構成できます。例えば、FTPまたはSCPを使用して入力ファイルを他のプログラムに転送する場合、RunExternalProgramに基づくステップを作成してファイルを転送できます。次に、RunHotFolderApplicationに基づくステップを追加して、［送信フォルダー］プロパティーを空白のままにします。ステップは、外部送信用ホットフォルダーにはファイルを送信しませんが、結果ファイルを検索するために検索フォルダーをポーリングします。

処理フロー：RunExternalProgram

RunExternalProgramステップテンプレートに基づくステップは、ジョブのスプールディレクトリーのファイルにアクセスできます。入力装置が入力ファイルからジョブを作成するとき、ジョブのために固有のスプールディレクトリーも作成します。スプールディレクトリーには入力ファイルと、ジョブに関する情報を提供するその他のファイルのコピーが入ります。外部ステップは、スプールディレクトリーにある既存のファイルを更新したり、新しいファイルをディレクトリーに書き込んだりするプログラムを呼び出すことができます。

RunExternalProgramステップテンプレートに基づくステップを作成するときは、次のプロパティーに対する値を含めることができます。

  • Job.External.Command
  • 外部制御ファイルテンプレート
  • 外部プログラムコードページ
  • 外部プログラム言語
  • 有効な戻りコード

次の図に、RunExternalProgramStepステップがジョブを処理する方法を示します。このステップはコマンドのメソッドとシンボルを解決し、必要な場合は制御ファイルを作成し、コマンドを実行し、他のプログラムが処理を完了したときに戻りコードを受け取り、そのプログラムが指定変更ファイルを送り返した場合はジョブプロパティーを更新します。次に、ジョブは次のステップに移動します。

RunExternalStepステップテンプレートの処理

この図は、RunExternalProgramStepステップがジョブを処理する方法を示します。このステップはコマンドのメソッドとシンボルを解決し、必要な場合は制御ファイルを作成し、コマンドを実行し、他のプログラムが処理を完了したときに戻りコードを受け取り、そのプログラムが指定変更ファイルを送り返した場合はジョブプロパティーを更新します。次に、ジョブは次のステップに移動します。

ジョブがRunExternalProgramステップに入ると、そのステップは［外部コマンド］プロパティーで提供されたコマンドを実行しようとします。コマンドにRICOH ProcessDirectorシンボル表記で記述された部分が含まれている場合、このステップはそのコマンドを発行する前にすべての参照を解決します。

  • コマンドには、次の2つのファイル名が含まれます。入力ファイル名（他のプログラムが取得するファイル）と出力ファイル名（他のプログラムがRICOH ProcessDirectorに返すファイル）です。ステップは、RICOH ProcessDirectorのメソッドgetFileName()を使用してこれらの名前を生成する必要があります。コマンド内で実際のファイル名を使用する代わりに、このメソッドはファイル名のシンボルとして使用されます。

    たとえば、入力ファイル名は${getFileName(print,pdf,read)}という記号で表され、出力ファイル名は${getFileName(print,pdf,write)}という記号で表されます。このメソッドを使用すると、アプリケーションは正しいファイルを検索して返すことができるようになります。

  • コマンドにはRICOH ProcessDirectorプロパティーに対するシンボルを含めることができます。その場合、それらのプロパティー値がコマンドに取り込まれます。

    たとえば、他のアプリケーションがジョブ名を確認する必要がある場合、シンボル${Job.Name}を含むことができます。ステップは ［ジョブ名］プロパティーの値を見つけて、それをコマンドに取り込みます。

  • アプリケーションは、パラメーターまたは制御ファイルのプロパティー値を受け入れます。

    その場合、制御ファイルの名前を作成するgetControlFileName()メソッドがコマンドに含まれます。ステップは ［外部制御ファイルテンプレート］プロパティーにリストされた制御ファイルテンプレートを使用して、制御ファイルの内容をビルドし、ファイル名をコマンドに挿入します。

  • アプリケーションは、JDFジョブチケットの値を受け入れることもあります。

    その場合は、JDFジョブチケットの名前を生成するgetFileName()メソッドがコマンドに含まれます。この構文の例は、${getFileName(overrides,jdf,read)}のようになります。

すべてのシンボルが解決された後で、コマンドが実行します。

外部アプリケーションはそれ自体の処理を実行し、出力ファイルを正しい場所にコピーし、戻りコードを返します。出力ファイルには、次のようなものが含まれます。

  • 変更された印刷ファイルで、コマンドに含まれたgetFileName()シンボルの値に基づいて名前が付けられたもの
  • プロパティー値をRICOH ProcessDirectorに戻すためのファイル

    RICOH ProcessDirectorは、次のような方法で外部プログラムからプロパティー値を受け入れます。

    • RICOH ProcessDirectorの属性と値のペアのリストを含むjobid.overrides.txtまたは.textというファイルによる
    • ファイル名に属性と値のペアを含む空のファイルによる（コマンドの出力パラメーターのプロパティー値のペアがファイルに含まれる場合はスプールファイルの場所に作成される）

このステップは、そのステップの［有効な戻りコード］プロパティーにリストされた値と戻りコードを比較します。リストされたコードの1つと一致する場合、処理は続行します。一致しない場合は、ジョブはエラー状態になります。

このステップは、プロパティー値を保有するファイルを検索します。ファイルを検出した場合は、そのファイル（またはファイル名）を読み取って、プロパティー値を更新します。その後、ステップは処理を完了します。ジョブを他のステップに渡すか、ワークフローの分岐を終了します。

処理フロー：RunHotFolderApplication

このステップを作成するとき、次のプロパティーに対する値を含めることができます。

  • ファイルサイズ検査カウント
  • 送信するファイル
  • ポーリング間隔
  • 検索フォルダー
  • 検索パターン
  • 検索済みファイル
  • 送信フォルダー
  • タイムアウト間隔

次の図に、RunHotFolderApplicationステップがジョブを処理する方法を示します。このステップは、送信するファイルの名前のメソッドおよびシンボルを解決し、送信場所にファイルをコピーし、外部プログラムがファイルを処理するのを待機します。このステップは、検索場所でファイルを監視して、その場所に完全にコピーされたときにファイルを取得します。次に、ジョブは次のステップに移動します。

このステップは、1つ以上のファイルを持つジョブを処理します。

RunHotFolderApplicationステップテンプレートの処理

この図は、RunHotFolderApplicationステップがジョブを処理する方法を示します。送信するファイルの名前のメソッドおよびシンボルを解決し、送信場所にファイルをコピーし、外部プログラムがファイルを処理するのを待機します。このステップは、検索場所でファイルを監視して、その場所に完全にコピーされたときにファイルを取得します。次に、ジョブは次のステップに移動します。

ジョブがこのステップに入ると、［送信するファイル］プロパティーの値を解決して、そのファイルをスプールディレクトリー内で検索します。このステップは、 ［送信フォルダー］プロパティーで指定された場所に印刷ファイルをコピーします。他のアプリケーションがこの場所からファイルを取得することを期待します。

ファイルがコピーされると、［検索フォルダー］プロパティーのリストにあるディレクトリーの監視を開始します。このステップは、そのフォルダーで ［検索パターン］に指定されたパターンを一致する名前のファイルを検索します。その基準と一致するファイルが存在しない場合、ステップは ［ポーリング間隔］プロパティーに指定された時間待機して、再度チェックします。

指定された時間が経過するまで、ファイルのチェックを継続します。この時間の長さは、［タイムアウト間隔］プロパティーの値で決定されます。タイムアウト間隔は、印刷ファイルが ［送信フォルダー］にコピーされてからの時間で計算されます。変更されたファイルがタイムアウト間隔が経過するまでに ［検索フォルダー］に存在しない場合、ジョブはエラー状態になります。

ステップがそのディレクトリーで予期したファイルを初めて検出したときは、ファイルのサイズを記録しますが、それ以外は何もしません。ステップは、処理を続行する前に、ファイル全体が他のアプリケーションから転送されたことを確認する必要があります。ポーリング間隔が経過すると、ステップは再度チェックし、ファイルを見つけ、ファイルのサイズを前回のチェックと比較します。

  • ファイルが前回より大きくなっている場合、ステップは待機を続けて、再度ポーリング間隔が経過したときに再度サイズをチェックします。
  • ファイルのサイズが前回と同じ場合、ファイルサイズが変化していないと注記され、「2回にわたってサイズは同じでした」のように表示されます。

    ステップは、［ファイルサイズ検査カウント］の値を確認します。ファイルサイズが同じになった回数がこの値に達すると、ファイルが完全にコピーされたとステップがみなすようになります。ファイルサイズが同じだった回数がファイルサイズ検査カウントと等しくなった場合、そのステップはファイルが完了したとみなします。

ファイルが完了すると、ステップは［検索済みファイル］プロパティーの値に基づいてそのファイルの名前を変更し、ジョブのスプールディレクトリーにコピーします。その後、ステップは処理を完了します。ジョブを他のステップに渡すか、ワークフローの分岐を終了します。

注意: RICOH ProcessDirectorは、特定の外部プログラムとのインターフェースとして機能する、個別に販売されている機能を提供します。具体例としては、Avanti Slingshot接続、Quadient Inspire接続、PitStop接続、Ultimate Impostrip®接続が挙げられます。Postal Enablementは、複数の外部プログラムと連携します。
  • Avanti Slingshot Connectは、Avanti Slingshot Management Information Systemとのインターフェースとして機能します。
  • PitStop Connectは、Enfocus PitStop Server 10以上とのインターフェースとして機能します。
  • Postal Enablementは、Bell and Howell BCC Mail ManagerやTEC Mailing Solutions MailPreparerなど、郵便最適化ソフトウェアとのインターフェースとして機能します。
  • Quadient Inspire接続は、Quadient Inspire Designerバージョン8以上とのインターフェースとして機能します。
  • Ultimate Impostrip®接続は、Windows上のUltimate Impostrip®自動化またはスケーラブルとのインターフェースを提供します。

RICOH ProcessDirectorは、これらの機能とともに外部プログラムソフトウェアを提供するわけではありません。

In this section:

  1. 外部プログラムを設定する
    外部ステップ用の構成タスクを開始する前に、外部ステップが呼び出す外部プログラムをセットアップする必要があります。
  2. 外部ステップ
  3. 外部ステップ用にステップテンプレートを設定する
    外部プログラムを呼び出すコマンドを含むステップテンプレートを作成できます。次に、外部プログラムがインストールされているLinuxまたはWindowsシステムで実行されるように、ステップテンプレートを調整します。
  4. 外部ステップ用にワークフローをセットアップする
    外部プログラムを呼び出すためのステップテンプレートを作成し、その外部プログラムがインストールされているサーバーで実行するようにステップテンプレートを調整した後で、そのステップテンプレートに基づいたステップをワークフローに追加します。次にワークフローを入力装置に割り当てるか、または別のメソッドを使用してワークフローを特定のジョブに割り当てます。
上位層のトピック： 他のアプリケーションと統合する