XML変換ジョブの構成

XML変換ジョブを作成してXMLファイルを目的の出力に変換し、XMLからキャプチャ・メタデータ・フィールドの値を割り当てることができます。これを実行するには、XSLTプロセッサ定義のサポート済組合せを構成し、カスタムXSLTファイルを指定します。さらに、XPath式をキャプチャ・メタデータ・フィールドにマップできます。変換済のXMLファイルをサードパーティ・アプリケーションで使用して、他のパーティのビジネス・ニーズにあわせることができます。

注:

Oracle Content Management Starter EditionではXML変換ジョブを作成できません。この機能を使用するには、Oracle Content Management Premium Editionにアップグレードする必要があります。詳細は、Starter EditionとPremium Editionを参照してください。

  1. 左側のプロシージャ・ペインで、プロシージャを選択します。

    選択したプロシージャの構成ページが右側に表示されます。

  2. 「処理」タブを開きます。

  3. 「XML変換ジョブ」表でXML変換ジョブの追加をクリックするか、既存のジョブを編集する場合はXML変換ジョブの編集をクリックします。

    また、XML変換ジョブを選択して変換ジョブのコピーをクリックし、プロンプトが表示されたら新規の名前を入力して、XML変換ジョブをコピーすることもできます。ジョブをコピーすると、すばやく複製および変更できます。

  4. 「ドキュメントの選択」ページで:

    1. 「ドキュメントの選択」セクションで次のようにします:

      • ジョブの名前と説明を入力します。

      • 特定のドキュメント・プロファイルのXML変換ジョブを処理するには、「ドキュメント・プロファイルに制限」フィールドにリストされているドキュメント・プロファイルを1つ以上選択するか、「すべて」を選択して、定義されているすべてのドキュメント・プロファイルのドキュメントを処理します。

    2. 変換の出力先ドロップダウン・リストで適切なオプションを選択します:
      • ドキュメント: 元のドキュメントを変換の結果に置き換えます。必要に応じて、ドキュメント・プロファイルを変更することもできます。
      • ドキュメント、コピーの保持: 元のコピーを保持します。このオプションを選択した場合、ドキュメント・プロファイルを選択することもできます。ただし、添付タイプの保持ドロップダウン・リストから添付タイプを選択する必要があります。
      • 添付: 変換の結果を添付として格納します。「新規添付タイプ」ドロップダウン・リストから添付タイプを選択する必要があります。
      • キャプチャ・フィールド: 「キャプチャ」フィールドに変換の結果を格納します。「キャプチャ・フィールド」ドロップダウン・リストから「テキスト・フィールド」を選択する必要があります。
    3. 「添付の選択」セクションで、次のようにします:
      1. 前のステップで行った選択に適用可能であれば、「添付の処理」チェック・ボックスを選択します。
      2. 使用可能な添付タイプにチェック・ボックスを選択して、必要な添付タイプに制限します。これらのすべての選択することもできます。
      3. 変換出力宛先を選択します:
        • 添付: 添付タイプを変更するオプションがあります。
        • 添付、コピーの保持: 添付タイプを選択するオプションがあります。ただし、添付タイプの保持ドロップダウン・リストから添付タイプを選択する必要があります。
        • キャプチャ・フィールド: 「テキスト・フィールド」または「XMLフィールド」を選択する必要があります。
  5. 「変換」ページの「変換定義」で次のようにします:
    1. XML変換の実行チェック・ボックスがまだ選択されていない場合、これを選択して、このページでフィールド値を編集できるようにします。このチェック・ボックスの選択を解除すると、編集は無効になりますが、最後にフィールドに保存した値は保持されます。XML変換が不要の場合、このチェック・ボックスの選択を解除できます。
    2. 「変換エンジン」セクションで次のようにします:
      • 互換性のある「XSLTバージョン」、「プロセッサ」および「プロセッサ・バージョン」を選択します。システムのデフォルトを選択するか、Xalanと互換性のある使用可能なXSLTバージョンおよびSaxon-HEプロセッサとそのバージョンから選択します。
      • XML、HTML、JSON、テキストなどの「出力ファイルの拡張子」を指定します。

        注:

        出力ファイルの拡張子がXMLでない場合、「フィールド・マッピング」ページが無効になります。
    3. 変換を実行するには、「XMLスタイルシート」セクションでXSLTをアップロードまたは入力します。
    4. XSLTに含めたパラメータは、「パラメータ」表で定義されている必要があります。これを行うには:
      1. 「パラメータ」表で「パラメータの追加」をクリックします。
      2. XSLTパラメータの追加ダイアログで、パラメータ名を追加し、これに値を割り当てます。テキスト値を追加するか、パラメータ用にメタデータ値を組み立てます。
      3. ステップiとiiを繰り返し、必要なパラメータを定義します。

        注:

        XSLTで定義されているパラメータに値を割り当てていない場合、またはXSLTに存在しないパラメータに値を割り当てている場合、XML変換ジョブを保存できず、変換ジョブを保存しようとしたときに通知されません。
    5. 「変換テスト」セクションで、変換済XMLをアップロードおよびテストし、適切に生成されていることを確認し、「次」をクリックします。このセクションの右側の上部で「プレビュー」をクリックして、このセクションでコンテンツをプレビューすることもできます。
  6. 「フィールド・マッピング」ページで、ユーザーがXMLドキュメントから値を抽出できるように、特定の要素または属性へのナビゲーションを定義します:
    1. XPathフィールド・マッピングの実行Perform XPath Field Mappingチェック・ボックスを選択して、「XPathフィールド・マッピング」表を編集できるようにします。このチェック・ボックスの選択を解除した場合、表は編集できなくなります。ただし、最後に保存した値は保持されます。
    2. 次のステップで選択する解析フォーマットが厳密に準拠している必要がある場合、解析エラーのバッチの失敗チェック・ボックスを選択します。
    3. 「XPathフィールド・マッピング」表の右上で、「XPathフィールド・マッピングの編集」をクリックします
    4. 「XPathフィールド・マッピングの編集」ダイアログで次のようにします:
      1. 「XPath式」フィールドで選択済メタデータのデータ・フィールドにXPath式を指定して、解析フォーマットを選択します。

        XPath式は、存在する場合に変換の出力で評価されます。変換を実行しない場合、XPath式はドキュメントまたは添付で評価されます。

      2. 日付解析フォーマット・ドロップダウン・リストで、解析フォーマットを選択します。「キャプチャ」フィールドが数値の場合、かわりに数値解析フォーマット・ドロップダウン・リストが表示されます。必要に応じて、カスタム解析フォーマットをドロップダウン・リストで選択できます。
      3. 「OK」をクリックします。

        「XPathフィールド・マッピング」表の「XPath式」列に追加した値が選択したフォーマットで日付に解析されます。

    5. 「OK」をクリックします。
  7. 「後処理」ページで、XML変換ジョブの完了後の処理を次に基づいて指定します:
    • システム・エラーなしの状況は、前のページのすべての基準が満たされた場合です。成功した変換はコミットに進むことができます。
    • システム・エラーとは、レコードが見つからない、見つかったレコードが多すぎるなど、変換が失敗した場合のことです。失敗した変換の場合、バッチは修復のためにコンテンツ・キャプチャ・クライアントに戻ります。
    XML変換ジョブの後処理とモニタリングの構成を参照してください

  8. 「サマリー」ページの設定を確認して「送信」をクリックし、ジョブを保存します。

  9. バッチのXML変換ジョブへの進め方を構成します。XML変換ジョブへのバッチ・フローの構成を参照してください。

  10. 作成したXML変換ジョブをテストします。

XML変換ジョブの後処理とモニタリングの構成

XML変換ジョブの後処理オプションを使用して、処理の完了後の処理を指定します。

XML変換ジョブの後処理およびモニタリングを構成するには:
  1. 左側のプロシージャ・ペインで、プロシージャを選択します。
    選択したプロシージャの構成ページが右側に表示されます。
  2. 「プロセッサ」タブを開きます。
  3. 「XML変換ジョブ」表で、XML変換ジョブを追加または編集します。
  4. 「後処理」ページをクリックして、成功した処理(システム・エラーなし)および失敗した処理(1つ以上のシステム・エラー)に対する処理オプションを表示します。次のステップは、システム・エラーがない場合とシステム・エラーがある場合の両方の項に適用されます。
  5. 「バッチ・プロセッサ」および「バッチ・プロセッサ・ジョブ」フィールドで、XML変換ジョブの完了後の処理ステップがある場合、処理ステップを指定します。「なし」、コミット・プロセッサ、認識プロセッサ、TIFFへの変換、PDFへの変換、アセット・ルックアップ・プロセッサまたはXML変換プロセッサから選択できます。
  6. 電子メール・アドレスのフィールドに、オプションで、処理が正常に完了または失敗した後に電子メールを送信する宛先のアドレスを入力します。XML変換ジョブの構成およびテストの際、システム・エラー時に電子メール通知を受信し、後で管理者に処理エラーを自動的に警告するように設定することができます。
  7. 残りの各フィールドで、処理済のバッチを変更する方法を指定します。

    • 接頭辞を追加することにより、バッチの名前を変更します。たとえば、失敗したバッチは、フォローアップのために接頭辞ERRを付けた名前に変更します。

    • バッチ・ステータスまたは優先度を変更します。たとえば、システム・エラーのあるバッチのステータスを変更してから、バッチ・フィルタリングをこのステータスに設定したクライアント・プロファイルを作成すると、適格なユーザーが、エラーの発生したバッチを手動で編集して完了できるようになります。

  8. 「送信」をクリックして、ジョブを保存します。

XML変換ジョブへのバッチ・フローの構成

XML変換ジョブを実行するには、処理のためにジョブに送られるようにバッチを構成する必要があります。これを行うには、クライアント・プロファイルでXML変換ジョブを後処理ステップとして設定します。

バッチ・フローは次のものから構成できます:

XML変換ジョブの非アクティブ化または削除

XML変換ジョブを削除すると、このジョブが後処理ステップとして設定されているバッチにこのジョブは使用できなくなります。後処理に指定されたジョブが使用できない場合は、バッチにエラーが発生します。ジョブを削除する前にしばらくの間オフラインに変更して、その削除に伴う予期しない問題を解決できるようにしておくのが望ましい場合もあります。オンラインXML変換ジョブは、クライアント・プロファイルまたはプロセッサ・ジョブの「後処理」ページで選択されている場合に実行されます。ジョブを一時的に停止(オフラインに)したり、非アクティブ化されたジョブを再実行するように変更することができます。

XML変換ジョブを非アクティブ化または削除するには:
  1. 左側のプロシージャ・ペインで、プロシージャを選択します。
    選択したプロシージャの構成ページが右側に表示されます。
  2. 「処理」タブを開きます。
  3. ジョブを非アクティブ化するには、「XML変換ジョブ」表で選択し、XML変換ジョブの非アクティブ化またはアクティブ化をクリックします。

    「ドキュメントの選択」ページで「オンライン」フィールドを選択したり、選択解除して、XML変換ジョブを非アクティブにしたり、アクティブにすることもできます。

  4. 非アクティブ化したジョブを「XML変換ジョブ」表で選択し、XML変換ジョブの削除をクリックします。
  5. プロンプトが表示されたら、「はい」をクリックしてこのジョブを削除することを確認します。