機械翻訳について
  1. Oracle Content Managementでのコンテンツのキャプチャ
  2. プロシージャの設定
  3. 処理設定の構成
  4. XML変換ジョブの構成

XML変換ジョブの構成

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

ノート:

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

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

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

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

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

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

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

    1. 「ジョブ詳細」セクションで:

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

      • 「プロセス・アクション」セクションで、「変換」チェック・ボックスを選択して、XMLへのコンテンツの変換を有効にします。
      • 「プロセス・アクション」セクションで、「フィールド・マッピング」チェック・ボックスを選択して、「XPathフィールド・マッピング」表の編集を有効にします。
      • 「プロセス・アクション」セクションで、「エレメント抽出」チェック・ボックスを選択して、要素の抽出を有効にします。
    2. 「ドキュメントの選択」セクション:
      • 前のステップで行った選択肢に適用可能な場合は、「プロセス文書」チェック・ボックスを選択します。

        ノート:

        このチェック・ボックスが選択されている場合のみ、出力ページで「文書宛先」セクションが有効になります。

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

    3. 「添付の選択」セクションで、次のようにします:
      1. 前のステップで行った選択に適用可能であれば、「添付の処理」チェック・ボックスを選択します。

        ノート:

        このチェック・ボックスが選択されている場合のみ、出力ページで「添付先」セクションが有効になります。
      2. 使用可能な添付タイプにチェック・ボックスを選択して、必要な添付タイプに制限します。 これらのすべての選択することもできます。
  5. 「変換定義」ページの「変換エンジン」セクションで、次の手順を実行します:
    • 互換性のある「XSLTバージョン」、「プロセッサ」および「プロセッサ・バージョン」を選択します。 システムのデフォルトを選択するか、Xalanと互換性のある使用可能なXSLTバージョンおよびSaxon-HEプロセッサとそのバージョンから選択します。
    • XML、HTML、JSON、テキストなどの「出力ファイルの拡張子」を指定します。

      ノート:

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

        ノート:

        XSLTで定義されているパラメータに値を割り当てていない場合、またはXSLTに存在しないパラメータに値を割り当てている場合、XML変換ジョブを保存できず、変換ジョブを保存しようとしたときに通知されません。
    3. 「変換テスト」セクションで、変換済XMLをアップロードしてテストし、正しく生成されたことを確認して、「次」をクリックします。 このセクションの右側の上部で「プレビュー」をクリックして、このセクションでコンテンツをプレビューすることもできます。
  7. 「出力先」ページの「文書宛先」セクションで、次の手順を実行します:
    1. 「変換出力先」ドロップダウン・リストで、次のいずれかを選択します:
      • ドキュメント: 元のドキュメントを変換の結果に置き換えます。 必要に応じて、「新規文書プロファイル」ドロップダウン・リストでドキュメント・プロファイルを変更することもできます。
      • ドキュメント、コピーの保持: 元のコピーを保持します。 このオプションを選択した場合、ドキュメント・プロファイルを選択することもできます。 ただし、添付タイプの保持ドロップダウン・リストから添付タイプを選択する必要があります。
      • 添付: 変換の結果を添付として格納します。 「新規添付タイプ」ドロップダウン・リストから添付タイプを選択する必要があります。
      • キャプチャ・フィールド: 変換の結果を取得フィールドに格納します。 「キャプチャ・フィールド」ドロップダウン・リストから「テキスト・フィールド」を選択する必要があります。
    2. 「新規文書プロファイル」ドロップダウン・リストで、オプションで新しいドキュメント・プロファイルを設定できます(または、このフィールドを設定せずに現在のドキュメント・プロファイルを保持できます)。
    3. 「添付タイプの保持」ドロップダウン・リストは、「変換出力先」フィールドで「ドキュメント、コピーを保持」オプションを選択した場合にのみ有効になります。 該当する場合は、関連するタイプを選択します。 分類タブから特定の添付タイプの使用をオプトアウトする場合は、「なし」を選択できます。
    4. 「新規添付タイプ」ドロップダウン・リストは、「変換出力先」フィールドで添付オプションを選択した場合にのみ有効になります。 このドロップダウン・リストには、ドキュメント・プロファイルで構成した添付タイプが表示されます。 ドキュメント・プロファイルに添付タイプが含まれていない場合は、「添付タイプ」セクションの分類タブで作成したタイプを選択できます。 「なし」は、アタッチメント・タイプを考慮する必要がない場合、または使用可能なものがない場合は選択できます。 該当する場合は、関連するタイプを選択します。
    5. 「キャプチャ・フィールド」ドロップダウン・リストは、「変換出力先」フィールドで「キャプチャ・フィールド」オプションを選択した場合にのみ有効になります。 該当する場合は、使用可能なオプションからフィールドを選択します。
  8. 「出力先」ページの「添付先」セクション(このセクションは、「添付処理」セクションで「プロセス添付」チェック・ボックスを選択した場合に有効になります):
    1. 「変換出力先」ドロップダウン・リストで、次のいずれかを選択します:
      • 新規添付タイプ: 添付タイプを変更するオプションがあります。 このドロップダウン・リストには、ドキュメント・プロファイルで構成した添付タイプが表示されます。 ドキュメント・プロファイルに添付タイプが含まれていない場合は、「添付タイプ」セクションの分類タブで作成したタイプを選択できます。
      • 添付タイプの保持: 添付タイプを選択できます。 ただし、添付タイプの保持ドロップダウン・リストから添付タイプを選択する必要があります。
      • キャプチャ・フィールド: テキスト・フィールドまたはXMLフィールドを選択する必要があります。
    2. 「新規添付タイプ」ドロップダウン・リストは、「変換出力先」フィールドで添付オプションを選択した場合にのみ有効になります。 このドロップダウン・リストには、ドキュメント・プロファイルで構成した添付タイプが表示されます。 ドキュメント・プロファイルに添付タイプが含まれていない場合は、「添付タイプ」セクションの分類タブで作成したタイプを選択できます。 「なし」は、アタッチメント・タイプを考慮する必要がない場合、または使用可能なものがない場合は選択できます。 該当する場合は、関連するタイプを選択します。
    3. 「添付タイプの保持」ドロップダウン・リストは、「変換出力先」フィールドで「ドキュメント、コピーを保持」オプションを選択した場合にのみ有効になります。 該当する場合は、関連するタイプを選択します。 分類タブから特定の添付タイプの使用をオプトアウトする場合は、「なし」を選択できます。
    4. 「キャプチャ・フィールド」ドロップダウン・リストは、「変換出力先」フィールドで「キャプチャ・フィールド」オプションを選択した場合にのみ有効になります。 該当する場合は、使用可能なオプションからフィールドを選択します。
  9. 「フィールド・マッピング」ページで、ユーザーがXMLドキュメントから値を抽出できるように、特定の要素または属性へのナビゲーションを定義します:
    1. 次のステップで選択する解析フォーマットが厳密に準拠している必要がある場合、解析エラーのバッチの失敗チェック・ボックスを選択します。
    2. 「XPathフィールド・マッピング」表の右上で、をクリックします「XPathフィールド・マッピングの編集」
    3. 「XPathフィールド・マッピングの編集」ダイアログで次のようにします:
      1. 「XPath式」フィールドで選択済メタデータのデータ・フィールドにXPath式を指定して、解析フォーマットを選択します。

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

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

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

    4. 「OK」をクリックします。
  10. 「エレメント抽出」ページで、プライマリ・ドキュメントおよびXML要素の宛先からXML要素を抽出するXPath式を指定します:
    1. オプションで、「XML要素が見つからない場合、バッチに失敗」チェック・ボックスを選択すると、要素の抽出時にXML要素が見つからない場合にバッチ・エラーが発生します。
    2. 「XPath式」フィールドで、プライマリ・ドキュメントから抽出するXML要素に基づいてXPath式を指定します(次のコード・サンプルを参照)。 各要素は選択した宛先に保存されます。 
      <?xml version="1.0" encoding="utf-8" ?>
<invoice>
  <invoicenumber>INT-3343</invoicenumber>
  <invoicedate>2020-01-31</invoicedate>
  <purchaseordernumber>1949/2020</purchaseordernumber>
  <duedate>2020-02-14</duedate>
  <address type="shipto">
    <name>Road Runner</name>
    <street>1 Desert road east</street>
    <zipcode>2014</zipcode>
    <city>SW Am. desert</city>
  </address>
  <address type="billto">
    <name>Wile E. Coyote</name>
    <street>1 Desert road west</street>
    <zipcode>1949</zipcode>
    <city>SW Am. desert</city>
  </address>
  <lineitems>
    <lineitem>
      <quantity>20</quantity>
      <description>Explosive tennis balls</description>
      <unitprice>$5.00</unitprice>
      <amount>$100.00</amount>
    </lineitem>
    <lineitem>
      <quantity>100</quantity>
      <description>Earthquake pills</description>
      <unitprice>$0.50</unitprice>
      <amount>$50.00</amount>
    </lineitem>
  </lineitems>
  <subtotal>$150.00</subtotal>
  <tax>$7.50</tax>
  <total>$157.50</total>
  <terms>15 days</terms>
</invoice>
      上の例では:
      • /invoice/lineitems/lineitem XPath式は、すべてのlineitem要素を抽出します:
         <lineitems>
    <lineitem>
      <quantity>20</quantity>
      <description>Explosive tennis balls</description>
      <unitprice>$5.00</unitprice>
      <amount>$100.00</amount>
    </lineitem>
    <lineitem>
      <quantity>100</quantity>
      <description>Earthquake pills</description>
      <unitprice>$0.50</unitprice>
      <amount>$50.00</amount>
    </lineitem>
  </lineitems>

      • /invoice/lineitems/lineitem[quantity > 10] XPath式は、これらのアイテムが10を超える場合に、すべてのlineitem要素を抽出します: 

         <lineitems>
    <lineitem>
      <quantity>20</quantity>
      <description>Explosive tennis balls</description>
      <unitprice>$5.00</unitprice>
      <amount>$100.00</amount>
    </lineitem>
    <lineitem>
      <quantity>100</quantity>
      <description>Earthquake pills</description>
      <unitprice>$0.50</unitprice>
      <amount>$50.00</amount>
    </lineitem>
  </lineitems>
      • /invoice/address[@type = 'billto'] XPath式は、請求先住所要素を抽出します:
        <address type="billto">
    <name>Wile E. Coyote</name>
    <street>1 Desert road west</street>
    <zipcode>1949</zipcode>
    <city>SW Am. desert</city>
  </address>
    3. 「XML要素宛先」フィールドで、抽出されたXML要素を保存する宛先を指定します。 使用できるオプションは次のとおりです。
      1. 「ドキュメント」 - この宛先を選択すると、元のプライマリ・ドキュメントがXPath式に一致する最初のXML要素に置き換えられ、後続の一致によって、同じメタデータ・フィールドと値でバッチに新しいドキュメントが作成されます。 オプションで、「新規文書プロファイル」ドロップダウン・リストで新しいドキュメント・プロファイルを設定できます(または、このフィールドを設定せずに現在のドキュメント・プロファイルを保持できます)。
      2. 「ドキュメント、コピーを保持」 - コピーする添付タイプを選択します。 この宛先を選択すると、プライマリ・ドキュメントがXPath式に一致する最初のXML要素に置き換えられ、後続の一致によって、同じメタデータ・フィールドと値でバッチに新しいドキュメントが作成されます。 元のプライマリ文書は、選択した添付タイプの添付として保持されます。 オプションで、「新規文書プロファイル」ドロップダウン・リストで新しいドキュメント・プロファイルを設定できます(または、このフィールドを設定せずに現在のドキュメント・プロファイルを保持できます)。
      3. 「添付」 - このオプションを選択した場合は、「新規添付タイプ」ドロップダウン・リストで新しい添付タイプを選択します。 これにより、XPath式に一致するすべてのXML要素に対して選択した添付タイプの添付が作成されます。

    ノート:

    • ドキュメント・オプションのいずれかを選択すると、元のプライマリ・ドキュメントが最初のXML要素に置き換えられます。 XPath式が複数の要素を生成する場合、新しいドキュメントが作成され、バッチに追加されます。 結果として作成されるすべてのドキュメントには、同じメタデータ・フィールドと値があります。
    • この要素抽出ステップの前に(「変換」ページを使用して)変換を実行した場合、変換された出力は要素の抽出時に使用されます。 変換ページの「出力ファイル拡張子」フィールドのファイル拡張子としてxmlが指定されていない場合、「フィールド・マッピング」および「エレメント抽出」ページは、XPathマッピングおよび要素抽出はXML出力でのみ実行できるため無効になります。 変換の宛先がメタデータ・フィールドまたは新規添付である場合、フィールド・マッピングおよび要素抽出では元のドキュメントが使用されます。
  11. 「後処理」ページで、XML変換ジョブの完了後の処理を次に基づいて指定します:
    • システム・エラーなしの状況は、前のページのすべての基準が満たされた場合です。 成功した変換はコミットに進むことができます。
    • システム・エラーとは、レコードが見つからない、見つかったレコードが多すぎるなど、変換が失敗した場合のことです。 失敗した変換の場合、バッチは修復のためにコンテンツ・キャプチャ・クライアントに戻ります。
    「XML変換ジョブの後処理およびモニタリングの構成」を参照してください

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

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

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

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

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

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

    • 接頭辞を追加して、バッチの名前を変更します。 たとえば、失敗したバッチの名前を、追跡用に接頭辞ERRを付けて変更します。

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

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

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

XML変換ジョブを実行するには、処理のためにジョブに送られるようにバッチを構成する必要があります。 これを行うには、XML変換ジョブを「クライアント・プロファイル」、「インポート・プロセッサ・ジョブ」、または「処理設定」で説明されている処理ジョブの後処理ステップとして設定します。 バッチ・フローを構成するジョブまたはクライアント・プロファイルの後処理情報については、「処理設定の構成」または「取得設定の構成」を参照してください。

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

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

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

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

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