ジョブチケット読込:JSON

22 分読む 最終更新日 2023年01月11日

ジョブチケット読込:JSONノード

注意: このノードは、JSONファイルおよびZIP(JSON + PDF)ファイルに対応しています。JSONファイルはUTF-8(BOM無し)形式である必要があります。

ジョブチケット読込:JSONノード を使用して、JSONファイルに保存されている情報を解析し、解析済みの情報をメタデータとして書き込むことができます。JSONファイルには、ジョブチケットフィールドおよびジョブチケット値が含まれます。このノードでは、ジョブチケットフィールドとそれに対応するジョブチケットの値が読み取られてから、メタデータが更新されます。ジョブチケットデータをメタデータの値にマップするのに、マッピングテーブルが使用されます。

PDFファイルの場所は、JSONファイルのURLフィールドに記載されており、その情報を使用してPDFファイルがノードにダウンロードされます。入力ファイルがZIPファイル(JSON + PDF)である場合、ファイルが解凍されてから、JSONファイルが処理されます。

ジョブチケット読込:JSONノードを使う

ジョブチケット読込:JSON ノードアイコンをワークフロービルダーキャンバスにドラッグすることで、ジョブチケット読込:JSONノードをワークフローに追加できます。アイコンをダブルクリックすると、 [ジョブチケット読込:JSON] ウィンドウが開きます。

ジョブチケット読込:JSONノード

このウィンドウでは、UIの一部であるマッピングテーブルエディターを使用して、マッピングテーブルを作成またはインポートできます。

  • [有効] チェックボックスをオンにして処理が実行されるようにします。オフにすると、この処理は無視されます。ドキュメントは、ノードが存在していないかのように通過します(つまり、既定のパスまたは「Y(はい)方向の」パスを進み続けます)。無効になっているノードでは、論理条件やエラー条件がチェックされません。

  • [ノード名] フィールドに、ジョブチケット読込:JSONノードに付ける、わかりやすい名前を入力します。

  • [説明] フィールドに、ジョブチケット読込: JSONノードの説明を入力します。これは必須ではありませんが、複数の処理を相互に区別するのに役立ちます。説明が長い場合、このフィールドにマウスを合わせるとその内容全体を読むことができます。

  • [測定単位] 領域では、測定単位を選択します。mmインチ、およびポイントの3種類の測定単位がサポートされています。

    注意: すべての英語ロケールのシステムでは、デフォルトでインチが選択されます。その他のロケールでは、デフォルトはmmです。ロケールに関係なく、いずれかのオプションを選択できます。

  • ジョブチケット読込:JSONの設定を保存するには、[保存] ボタンを選択します。変更を保存せずにウィンドウを終了するには、 [キャンセル] ボタンを選択します。

  • オンラインヘルプにアクセスするには、[ヘルプ] ボタンを選択します。

[設定項目]パネル

ジョブチケットパラメータは、パネルに表示された11個のグループに分類されています。設定値を表示するには、いずれかのメニューオプションをクリックします。

ジョブチケット読込:JSONノード

  • [ジョブ設定]: [ジョブ設定]を選択して、[ジョブチケット番号]、[ジョブチケット名]、[ジョブ優先順位]、[期日]、[カラーモード]、[ハイクオリティカラー]、または [ジョブ詳細] のジョブチケットパラメータを編集します。

  • [基本設定][基本設定] を選択して、[部数][部単位で印刷][オフセット][部数仕分け][枚数仕分け][用紙カタログID][用紙名][給紙トレイ][坪量][用紙種類][色紙][ユーザー定義色][穴あき紙の使用][用紙幅][用紙高さ][用紙サイズ][用紙サイズ単位]、または [方向] のジョブチケットパラメータを編集します。

  • [レイアウト設定]: [レイアウト設定]を選択して、[面付] または [印刷タイプ] のジョブチケットパラメータを編集します。

  • [表紙設定]: [表紙設定]を選択して、[オモテ表紙]、[オモテ表紙の用紙名]、[ウラ表紙]、または [ウラ表紙の用紙名] のジョブチケットパラメータを編集します。

  • [仕上げ設定]:[仕上げ設定]を選択して、[とじ位置][中とじ][トリム][ステープル][パンチ][折り][くるみ製本][くるみ製本モード][くるみ製本トレイ][くるみ製本両面][くるみ製本背表紙][くるみ製本表紙幅][くるみ製本表紙高さ][くるみ製本表紙サイズ][くるみ製本表紙坪量][リングバインド][リングバインドオモテ表紙]、または [リングバインドウラ表紙] のジョブチケットパラメータを編集します。

  • [ページ単位設定]:[ページ単位設定]を選択して、[印刷種類][とじ位置][用紙カタログID][用紙名][給紙トレイ][用紙種類][用紙幅][用紙高さ][用紙サイズ][坪量][色紙][ユーザー定義色][穴あき紙の使用][タブ種類][ページ単位設定数][ステープル][パンチ設定][パンチ]、または [ステープル仕上げ] のジョブチケットパラメータを編集します。

  • [タブ設定][用紙幅][用紙高さ][用紙サイズ][坪量][タブ文字][ページ番号][ファイル順序]、または [タブ数] を選択します。

  • [画像品質設定]: [画像品質設定]を選択して [解像度] のジョブチケットパラメータを編集します。

  • [顧客情報]: [顧客情報]を選択して、[コメントURL]、[お客様の名前]、[お客様の姓]、[お客様の住所]、[お客様の丁目・番地]、[お客様の市区町村]、[お客様の都道府県]、[お客様の郵便番号]、[お客様の国]、[お客様の会社]、[お客様の電話番号]、[お客様のファクス番号]、[お客様の電子メール]、または [ジョブ作成者] のジョブチケットパラメータを編集します。

  • [ジョブダウンロード設定]: [ジョブダウンロード設定]を選択して、印刷ファイルの取得にどの印刷ファイルオプションを使用するかを指定します。指定できるオプションには [ローカルパスから取得]、[URLからダウンロード] または [ジョブチケットからbase64データを取得][ネットワーク共有からの取得] があります。

  • [その他]: どの設定項目にもないカスタムジョブチケットパラメータを扱う場合は、[その他] ページを使用して新しいフィールドを追加します。

ツールバー

ツールバーは、[ページ単位設定][その他] の設定項目オプションが選択されている場合にのみ表示されます。以下に示す例では、 [その他] の設定項目オプションが選択されています。ページ単位設定のツールバーは、この例とは異なります。以下に、利用可能なツールバーのオプションをすべて示します。

ジョブチケット読込:JSONノード

  • [新規追加]: 変換ルールを定義する新しいエントリーパラメータを追加するには、このオプションを使用します。このオプションは [その他] 設定項目でのみ使用できます。

  • [削除]: パラメータのエントリーを削除するには、このオプションを使用します。このオプションは [その他] 設定項目でのみ使用できます。

  • [ページ単位設定を追加]: 別の組み合わせのページ単位設定を追加するには、このオプションを使用します。このオプションは [ページ単位設定] 設定項目でのみ使用できます。

  • [ページ単位設定を削除]:ページ単位設定 のエントリーを削除するには、このオプションを使用します。このオプションは [ページ単位設定] 設定項目でのみ使用できます。

  • [マッピングテーブルのインポート]: クリックするとファイルのダイアログが開き、インポートするマッピングテーブルのxmlファイルを選択できます。

  • [マッピングテーブルのエクスポート]: 外部にあるマッピングテーブルのxmlファイルに適用した構成変更を保存するには、この機能を使用します。

  • [ジョブチケットリファレンス]:[ジョブチケットリファレンス]パネル の表示と非表示を切り替えるには、このオプションを使用します。

マッピングテーブルパネル

このパネルでは、ジョブチケットパラメータとDispatcherメタデータ間のマッピング値を定義します。設定項目の各オプションをクリックすると、メインパネルに[パラメータ名]/[メタデータキー]の値が表示されます。

ジョブチケット読込:JSONノード

  • [パラメータ名]: この列は、ジョブチケットパラメータのわかりやすい名前を示します。

  • [メタデータキー]: この列は、パラメータ名ごとのDispatcherメタデータキーを示します。

  • [ジョブチケットパス]: 既定では、この列は空です。この列には、各ジョブチケットパラメータに対応するJSONファイルのパスを入力します。

値マップパネル

メタデータ値とジョブチケット値間の変換ルールを定義するには、このパネルを使用します。テーブルに値を入力します。 メタデータキーとジョブチケットパスが列見出しに表示され、必要に応じてエントリーの追加や削除ができます。

ジョブチケット読込:JSONノード

  • [メタデータキーの追加]: 新しいメタデータキーを追加するには、このボタンをクリックします。

  • [ジョブチケットパスの追加]: 新しいジョブチケットパスを追加するには、このボタンをクリックします。

  • [行の追加]: 新しい値マップ行を追加するには、このボタンをクリックします。

  • [ジョブチケットの値を使用]: このチェックボックスをオンにすると、ジョブチケットの値がそれに対応するメタデータキーと共に保持され、変換が適用されずに保存されます。

    注意: チェックボックスは、1対1マッピングの場合にのみ使用できます。他のすべての条件では、このオプションはグレー表示され、有効にすることはできません。

[ジョブチケットリファレンス]パネル

ジョブチケット読込:JSONノード

[開く] ボタン(ジョブチケット読込:JSONノード)をクリックすると、サンプルのジョブチケットファイルを開くことができます。ジョブチケットを選択すると、そのチケットで使用できるJSONファイルのパスがすべてテーブルにリストで表示されます。このリストから項目をマッピングテーブルパネルへドラッグし、目的の [ジョブチケットパス] 列にドロップします。

このリストの内容を消去するには [クリア] ボタン(ジョブチケット読込:JSONノード)をクリックします。

マッピングテーブルの基本的な操作

ジョブチケットパラメータは、保管したりジョブチケットに対して特定の処理を行ったりする場合に、異なる形式に変換する必要のあることがしばしばあります。変換することで、そのような処理でのジョブチケットの読込が可能になります。このノードを使用すると、JSON形式に変換できます。

ジョブチケットファイル

このノードの使用を開始する前に、JSONジョブチケットファイルを生成する必要があります。

注意: アドインマネージャを使用してDispatcher Phoenixにジョブチケット読込:JSONノードを追加すると、サンプルのジョブチケットファイルを表示できます。これらのファイルは、以下のパスにあります。

\Program Files\Common Files\Konica Minolta\Phoenix\Resources\JobTicketParserJSONNode

上記のサンプルのジョブチケットには、そのチケットで使用できるすべてのジョブチケットパラメータが含まれています。ファイルをサポートするために必要なパラメータを含むように、サンプルのジョブチケットを変更できます。外部のサードパーティー製のアプリケーションを使用して、ジョブチケットファイルを生成することもできます。この場合、これをサンプルファイルとして使用できます。

ジョブチケット読込:JSONノードでは、ドキュメントレベル値とページ単位設定値を使用してジョブチケットパラメータを定義します。以下の説明では、サンプルのジョブチケットがシンプルなドキュメントとページ単位レベルの設定で変更されています。このサンプルのジョブチケットは、以降の説明に使用されます。

{
   “Ticket”: {
       “Name”: “Sample JSON Job”,
       “Quantity”: 5,
       “Duplex”: “On”,
       “Media”:
          {
             “Color”: “Yellow”
          },
       “File”: “file”,
       “Src”: “C:\\Temp\\Testfile.pdf”,
       “PageException”: [
          {
             “Range”: “1-5”,
             “Media”:
                {
                   “PaperName”: “A4”
                }
          }]
       }
}

ジョブチケットファイルを使用したマッピングテーブルの構成

  1. テキストエディタを使用して、上記のサンプルJSONファイルをコピーします。

  2. サンプルのジョブチケットに記載されているソースパス(“Src”)は(上記の例で説明したように)、パスが有効になるように変更する必要があります。

  3. ファイルを json_ sample_ jobticket_file.jsonとしてローカルに保存します。

  4. ジョブチケット読込:JSON ノードをダブルクリックします。次のように設定画面が開きます。

    ジョブチケット読込:JSONノード

  5. 左側のパネルで、次の値を設定します。

    • [有効] チェックボックス:オンにすると、ノードでジョブを受け入れることができます。

    • [ノード名]: ノードに割り当てる名前をテキストフィールドに入力します。

    • [測定単位]: ノードに適用する測定単位のラジオボタンを選択します。

    注意: 入力ジョブチケットにメタデータ値{job:paper.unit}が含まれている場合、[測定単位]フィールドで選択されている値はこのメタデータ値によって上書きされます。

  6. [ジョブチケットリファレンス] パネル(右端)で、[開く] アイコンを見つけます。

    ジョブチケット読込:JSONノード

  7. このアイコンをクリックして、開いた画面で、上記の手順3で保存したファイル(json_sample_jobticket_file.json)に移動して選択します。

    ジョブチケット読込:JSONノード

  8. ファイルが開くと、その内容(つまりXPath)が次の画像のように、[ジョブチケットリファレンス] パネルに表示されます。

    ジョブチケット読込:JSONノード

    注意: ロードされたジョブチケットは、[ジョブチケットリファレンス]パネルから正しい値をドラッグアンドドロップしてマッピングする必要があります。値が[ジョブチケットリファレンス]パネルに表示されない場合は、このヘルプファイルの指示に記載されている値を手動で入力してください。

XPathのマッピング

XPath値が使用可能になったら、メインパネルの [パラメータ名]/[メタデータキー] の値にマッピングする必要があります。そのためには、[ジョブチケットリファレンス] パネルの値をクリックし、その値をメインパネルの対応する [ジョブチケットパス] セルにドラッグします。

ノードの左側の [設定項目] パネルを使用して、いくつかのオプションを指定できます。オプションをクリックすると、メインパネルに含まれている [パラメータ名]/[メタデータキー] の値が開きます。

基本的な[パラメータ名]/[メタデータキー]の値のマッピング

  1. [設定項目] パネルで、[基本設定] オプションをクリックします。 [パラメータ名]、[メタデータキー]、および [ジョブチケットパス] 列がメインパネルに表示されます。

    ジョブチケット読込:JSONノード

  2. [ジョブチケットリファレンス] パネルの値を、その値の [パラメータ名] に対応する、 [ジョブチケットパス] 列の空いているセルに移動する必要があります。

  3. [コピー] 行の [ジョブチケットパス] セルに $.Ticket.Quantity をドラッグアンドドロップします。[色紙] 行の [ジョブチケットパス] セルに $.Ticket.Media.Color をドラッグアンドドロップします。

  4. ドラッグアンドドロップした値は、[ジョブチケットリファレンス] パネルから削除されます。

    ジョブチケット読込:JSONノード

  5. [設定項目] パネルで、[レイアウト設定] オプションをクリックします。 [パラメータ名]、[メタデータキー] および [ジョブチケットパス] 列が、メインパネルに表示されます。

    ジョブチケット読込:JSONノード

  6. [ジョブチケットリファレンス] パネルの値を、その値の [パラメータ名] に対応する、 [ジョブチケットパス] 列の空いているセルに移動する必要があります。

  7. [印刷タイプ] 行の [ジョブチケットパス] セルに $.Ticket.Duplex をドラッグアンドドロップします。

    ジョブチケット読込:JSONノード

  8. ドラッグアンドドロップしたすべての値は、[ジョブチケットリファレンス] パネルから削除されます。

  9. 必要に応じて、他の [設定項目] オプションについて同じ手順を繰り返します。

[ページ単位設定]の[パラメータ名]/[メタデータキー]の値のマッピング

[ページ単位設定]設定項目 は、ページ単位設定を構成するために使用されます。これらの設定を有効にするには、XPath値を有効にしてマッピングする必要があります。このページ単位設定は、ページレベルのメタデータを生成します。

  1. [設定項目] パネルで、[ページ単位設定] オプションをクリックします。 [ページ番号のパス1]、[パラメータ名]/[メタデータキー]、および [ジョブチケットパス] フィールドが、メインパネルに表示されます。

    ジョブチケット読込:JSONノード

  2. [ジョブチケットリファレンス] パネルから、$.Ticket.PageException.Range[ページ番号のパス1] テキストボックスにドラッグアンドドロップします。

    注意[ページ番号のパスn] の内容は”$.“で始まる文字列である必要があります。

  3. [ジョブチケットリファレンス] パネルから、$.Ticket.PageException[0].Media.PaperName[用紙名] 行の *[ジョブチケットパス] セルにドラッグアンドドロップします。

    注意: PageException[0]をPageExceptionに変更します。

  4. 完了した画面は次のように表示されます。

    ジョブチケット読込:JSONノード

  5. ドラッグアンドドロップしたすべての値は、[ジョブチケットリファレンス] パネルから削除されます。

  6. 必要に応じて、他の [設定項目] オプションについて同じ手順を繰り返します。

[ジョブダウンロード設定]の[パラメータ名]/[メタデータキー]の値のマッピング

[ジョブダウンロード設定]設定項目 は、ジョブのPDFファイルの受信元となる入力ソースを有効にするために使用されます。[ローカルパスから取得]、[URLからダウンロード]、および [ジョブチケットからbase64データを取得](PDFデータはbase64形式で埋め込まれています)、[ネットワーク共有からの取得] の4つの値がサポートされています。

これらの設定を有効にするには、XPath値を有効にしてマッピングする必要があります。

サンプルJSONジョブチケットファイル:

以下の例は、各ジョブダウンロードオプションで、コードによりPDFファイルがどのように表示されるかを示しています。

ローカルパスから取得

    •    “File”: “file”
    •    “Src”: “C:\\Temp\\Testfile.pdf”
        注意:ファイルタイプキーワード fileと入力するジョブチケットファイルに記載されたファイルタイプのキーワードは一致している必要があります。

URLからダウンロード

    •    “File”: “http”
    •    “Src”: “http://10.146.171.98/testapp8/Testfile.pdf”
        注意:ファイルタイプキーワード httpと入力するジョブチケットファイルに記載されたファイルタイプのキーワードは一致している必要があります。

ジョブチケットからbase64データを取得

    •    “File”: “base64”
    •    “Src”: “xxddgdfexdgfgngn…”
        注意:ファイルタイプキーワード base64と入力するジョブチケットファイルに記載されたファイルタイプのキーワードは一致している必要があります。

ネットワーク共有から取得

    •    “File”: “share”
    •    “Src”: “\\\\11.12.13.14\\Temp\\Testfile.pdf”
        注意:ファイルタイプキーワード shareと入力するジョブチケットファイルに記載されたファイルタイプのキーワードは一致している必要があります。

  1. [設定項目] パネルで、[ジョブダウンロード設定] オプションをクリックします。 [ドキュメントソース]、[印刷ファイルの取得方法]、および [ジョブチケットパス:ファイルタイプ] フィールドが、メインパネルに表示されます。

    ジョブチケット読込:JSONノード

  2. [印刷ファイルの取得方法] 列で、[ローカルパスから取得]、[URLからダウンロード]、および [ジョブチケットからbase64データを取得][ネットワーク共有からの取得] の4つのオプションのチェックボックスをすべて選択します。

  3. [ジョブチケットリファレンス] パネルから、 [ドキュメントソース] フィールドに $.Ticket.Src をドラッグアンドドロップします。

  4. [ジョブチケットリファレンス] パネルから、[ジョブチケットパス:ファイルタイプ] フィールドに $.Ticket.File をドラッグアンドドロップします。

  5. 完了した画面は次のように表示されます。

    注意:[ネットワーク共有からの取得] を選択する場合は、ネットワーク共有先でのネットワーク資格情報の登録をする必要があります。ネットワーク資格情報ボタンを選択してネットワジョブチケット読込:JSONノード ーク資格情報ウィンドウにアクセスします。このウィンドウでは、ユーザー名を選択し、適切なパスワードを入力します。

    ジョブチケット読込:JSONノード

  6. ドラッグアンドドロップしたすべての値は、[ジョブチケットリファレンス] パネルから削除されます。

  7. 必要に応じて、他の [設定項目] オプションについて同じ手順を繰り返します。

値マップの構成

この機能を使用して、ジョブチケットのパスに対して1つ以上の値を構成できます。以下の例では、[印刷タイプ] のXPath値がマッピングされています。これが完了すると、設定が編集され、Duplexに対して設定の値マップが指定されます。

  1. [設定項目] パネルで、[レイアウト設定] オプションをクリックします。

  2. [印刷タイプ] 行をクリックして、値マップパネルを開きます。

    ジョブチケット読込:JSONノード

  3. デフォルトでは、1つの値マップ行が表示されます。2つの値をマッピングする必要があるため、[行の追加] をクリックして、2つ目の値マップ行を追加します。

    ジョブチケット読込:JSONノード

  4. 1つ目の行で、[メタデータキー] ドロップダウンメニューから [Double-Sided] を選択し、ジョブチケットパスに対して「 On 」と入力します。

  5. Duplexの値がOnに設定され Double-Sided印刷が選択されているノードにジョブが送信されると、メタデータにDouble-Sided印刷が出力されます。

  6. 2つ目の行で、[メタデータキー] ドロップダウンメニューから [One-Sided] を選択し、ジョブチケットパスに対して「 Off 」と入力します。

  7. Duplexの値がOff に設定されOne-Sided印刷が選択されているノードにジョブが送信されると、メタデータに One-Sided] 印刷が出力されます。

  8. 終了したら、[保存] をクリックします。変更を元に戻すには、[キャンセル] をクリックします。

ジョブチケット読込:JSONノードワークフローのサンプル

ジョブチケット読込:JSONノード

上記のワークフローでは、ジョブチケットファイル(json_sample_jobticket_file.jsonなど)が 入力フォルダー に移動されます。これは、ジョブチケット読込:JSON ノードに送信され、ジョブチケットJSONがジョブチケットメタデータに変換されます。これが完了すると、データは メタデータ/ファイル ノードに転送され、XMLドキュメントに変換されます。そこから、XMLドキュメントが 出力フォルダー に転送されます。

入力フォルダーノード: ファイルを集めて、ジョブチケット読込:JSONノードへ送るように入力フォルダーを構成します。

ジョブチケット読込:JSONノード: このノードの目的と設定手順については、このセクションに先行する箇所で説明されています。

メタデータ/ファイルノード: このノードは、構成されたメタデータを抽出してXMLファイルとして保存し、このファイルをワークフローの次のノードに送ります。以下の手順に従って、メタデータ/ファイルノードを構成します。

  1. メタデータ/ファイルノードアイコンをダブルクリックして開きます。

  2. [有効] チェックボックスがオンになっていることを確認します。

  3. [出力設定][元のファイルを出力] を選択し、[メタデータファイル形式] ドロップダウンから [XML (*.xml)] を選択します。

  4. [メタデータファイル拡張子][出力ファイルの拡張子プラスメタデータファイルの拡張子] ラジオボタンを選択します。

  5. メインパネルの [抽出するメタデータの選択] ヘッダーの下にある [ジョブ] チェックボックスを選択します。

  6. [保存] をクリックして、変更を適用します。

    ジョブチケット読込:JSONノード

出力フォルダーノード: すべてのワークフロー処理が正しく適用されると、出力フォルダーノードで設定されたフォルダーパスにジョブが送られます。

以下の出力されたメタデータは、このドキュメントの前のセクションで説明した設定に基づいています。

<meta group="job" name="copy">
    <document>5</document>
</meta>
<meta group="job" name="file.URL">
    <document>C:\Temp\Testfile.pdf</document>
</meta>
<meta group="job" name="file.type">
    <document>file</document>
</meta>
<meta group="job" name="paper.color">
    <document>Yellow</document>
</meta>
<meta group="job" name="paper.name">
    <page number="1">A4</page>
    <page number="2">A4</page>
    <page number="3">A4</page>
    <page number="4">A4</page>
    <page number="5">A4</page>
</meta>
<meta group="job" name="printtype">
    <document>Double-Sided</document>
</meta>
<meta group="job" name="ticket.file">
    <document>C:\ProgramData\Konica Minolta\conopsd\var\blox\node_4\tmp.d\170711124550.049_000001json_sample_job_ticket_file.json</document>
</meta>

制限事項

次の制限事項に注意してください。

  1. このノードに入力できるZIPファイルには、PDFファイルとJSONファイルのみを含める必要があります。入力として指定されているZIPファイルが、PDFおよびJSONファイルを含むフォルダーが圧縮されている形式の場合はサポートされていません。