Oracle® Fusion Middleware

Oracle Business Process Managementプロジェクトの移行

12c (12.1.3)

E59419-04(原本部品番号:E40107-04)

2016年11月

Oracle Business Process Management (BPM) 10gR3プロジェクトをBPM 12cに移行する管理者向けの情報を提供します。

Oracle Fusion Middleware Oracle Business Process Managementプロジェクトの移行, 12c (12.1.3)

E59419-04

Copyright © 2015, 2016, Oracle and/or its affiliates. All rights reserved.

原本著者: Oracle Corporation

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

このガイドで説明する新機能

1 概要

- 1.1 このガイドの読み方

- 1.2 BPM移行の経路について

- 1.3 BPM移行の概要

- 1.4 BPM移行ユーティリティの概要

- 1.5 BPM 12cアプリケーション

2 BPM移行ユーティリティ

- 2.1 BPM移行ユーティリティについて

- 2.2 BPM移行ユーティリティがサポートされるプラットフォーム

- 2.3 BPM移行環境の前提条件

- 2.4 BPM移行ユーティリティの準備

- 2.5 BPM移行ユーティリティのオプション

- 2.6 スクリプト内でのコンポーネントの移行統計の生成

- 2.7 BPM移行ユーティリティの実行

- 2.8 BPM移行ユーティリティの出力

- 2.9 BPM移行ユーティリティの出力へのアクセス

- 2.10 BPM OU移行スクリプトについて

- 2.11 BPM OU移行スクリプトの準備

- 2.12 BPM OU移行スクリプトのオプション

- 2.13 OU移行スクリプトの実行

3 BPM移行ユーティリティを使用したプロジェクトの移行

- 3.1 BPMプロジェクトの移行の概要

- 3.2 移行ユーティリティの実行

- 3.3 BPM移行ユーティリティの移行レポートの理解

- 3.4 移行統計の理解

4 プロジェクトおよびプロセスの移行の理解

- 4.1 プロジェクト・アーティファクトの移行

- 4.2 BPMアクティビティの移行

- 4.2.1 イベントの移行

- 4.2.2 アクティビティの移行

- 4.2.3 ゲートウェイの移行

- 4.2.3.1 複数のゲートウェイの移行の理解

- 4.2.3.2 複数のゲートウェイの移行の完了

- 4.2.4 その他のプロセス・アーティファクトの移行

- 4.3 遷移の移行

- 4.3.1 期限推移の移行の理解

- 4.3.2 ビジネス・ルール推移の移行の理解

- 4.3.3 ビジネス・ルール推移の移行の完了

- 4.4 例外の移行

- 4.5 引数および引数マッピングの移行

5 カタログの移行の理解

- 5.1 ビジネス・カタログの移行

- 5.1.1 ビジネス例外の移行

- 5.2 BPMオブジェクトの移行

- 5.2.1 BPMオブジェクト属性の移行

- 5.2.2 BPMオブジェクト・プレゼンテーションの移行

- 5.3 事前定義済カタログの移行

- 5.4 イントロスペクトされたコンポーネントの移行

- 5.4.1 イントロスペクトされたXMLスキーマの移行

- 5.5 プロジェクト依存関係の移行

6 Business Process Languageの移行の理解

- 6.1 Business Process Languageコードの移行の概要

- 6.2 Business Process Languageの制御フロー文の移行

- 6.3 Business Process Languageの基本型の移行

- 6.4 Business Process Languageの移行後アクティビティ

7 BPMのAPIの移行の理解

- 7.1 APIの移行

8 制限および既知の問題

- 8.1 制限事項

- 8.2 既知の問題

- 8.2.1 BPMアクティビティの移行における既知の問題

はじめに

『Oracle Fusion Middleware Oracle Business Process Managementプロジェクトの移行』へようこそ。このドキュメントでは、移行ツール、移行技術、参考資料およびベスト・プラクティスについて説明します。これらを使用すると、Oracle Business Process Management 10gR3プロジェクトをOracle Business Process Management 12cに移行できます。

対象読者

このガイドは、Oracle Business Process Management (Oracle BPM) 10gR3プロジェクトをOracle BPM 12cに移行する方法を学習する開発者およびアナリストを対象としています。

このマニュアルでは、Oracle BPM 10gR3および12cプロジェクトとシステム・インフラストラクチャに関する十分な知識を持っていることを前提としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティへの取り組みについては、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)にアクセスしてください。

Oracleサポートへのアクセス

サポートを購入したオラクル社のお客様は、My Oracle Supportを介して電子的なサポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info、聴覚に障害があるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

詳細は、次のOracleドキュメントを参照してください。

Oracle Business Process Management Suite。

- Oracle Business Process Management Studioを使用したビジネス・プロセスの作成

- Oracle Business Process Composerによるビジネス・プロセスの開発

- Oracle Business Process Managementを使用したビジネス・ルールの設計

- Oracle Business Process Management Rulesランゲージ・リファレンス

- Oracle Business Process Managementを使用したプロセスの管理とモニタリング

Oracle SOA Suite

- Oracle SOAスイートでのSOAアプリケーションの開発

- テクノロジ・アダプタの理解

Oracle SOA SuiteおよびBPM Suiteのインストールおよび管理

- Oracle SOA SuiteおよびBusiness Process Managementのインストールおよび構成

- SOA SuiteおよびBusiness Process Management SuiteのQuick Start for Developersのインストール

- Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理

- Oracle BAMでのビジネス・アクティビティのモニタリング

- Oracle Business Intelligence Publisher開発者ガイド

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

このガイドで説明する新機能

この項では、Oracle Fusion Middlewareリリース12cにおけるOracle Business Process Management Migrationの新機能と製品の重要な変更点の概要を示します。

このリリースに追加された新機能はありません。このリリースのガイドには重要なバグ修正が含まれています。

使用しているスキンによっては、このガイドで示される画面は実装状態と異なる場合があります。相違点は軽微なものです。

既知の問題のリスト(リリース・ノート)については、http://www.oracle.com/technetwork/middleware/soasuite/documentation/releasenotes121300-2124738.htmlを参照してください。

1 概要

この章では、移行ユーティリティについて説明し、12c Oracle BPM Suiteの簡単な概要を示します。

この章の内容は次のとおりです。

- BPM移行の経路について

- BPM移行ユーティリティの概要

- BPM 12cアプリケーション

- このガイドの読み方

1.1 このガイドの読み方

このマニュアルは、次のタスクを実行するために必要な情報を提供します。

- 移行の習得(この章)

- BPM移行ユーティリティおよびBPM OU移行スクリプトの習得と使用
BPMプロジェクトの移行を参照してください

- ビジネス・プロセスの移行の理解および追加の手動手順による移行の完了
「プロジェクトおよびプロセスの移行の理解」を参照してください

- ビジネス・カタログの移行の理解および必要な場合は手動による移行の完了
「カタログの移行の理解」を参照してください

- 制限に関する問題のトラブルシューティングと既知の問題の習得
「制限事項と既知の問題」を参照してください

1.2 BPM移行の経路について

このトピックでは、BPM 10gR3とBPM 12cの間のBPM移行の経路をまとめます。

このガイドでは、BPMバージョン10gR3からBPMバージョン12cへのBPM Studioプロジェクトの移行に特に焦点を当てて説明します。Oracle BPM Studioは、Oracle JDeveloper環境で実行するプラグインとして提供され、これを使用すると、ビジネス・プロセスのモデル化と実装が可能です。

BPM 12c以外のターゲットへの移行については、このドキュメントの範囲外となります。

BPM 10gR3以前のリリースからBPM 12cに移行するには、まずBPM 10gR3に移行してからBPM 12cに移行する必要があります。

BPM 11gからBPM 12cへのプロジェクトの移行を実現するには、12cバージョンのBPM StudioでBPM 11gプロジェクトを開きます。

BPM 11gからBPM 12cへのライブ・データおよび進行中のプロセスの移行方法については、このドキュメントの範囲外となります。

Oracle Supportに連絡して移行のサポートを受けるには、「はじめに」を参照してください。

1.3 BPM移行の概要

このトピックでは、プロジェクト移行の機能およびアプローチについて概説します。

BPM 10gR3とBPM 12cとの間には、アーキテクチャ、ツール、アプリケーション、機能および内部実装の面で違いがあります。

一部の10gR3要素は変更なしで12cに正常に移行できますが、12cの新しい構成概念を含む全体を交換するなど、ある程度の手動操作が必要になる要素もあります。

1.4 BPM移行ユーティリティの概要

このトピックでは、BPM移行ユーティリティ、その機能、およびそれにより作成される出力アーティファクトの概要を示します。

BPM移行ユーティリティは、Antに基づいたユーティリティで、BPM 10gR3プロジェクトをBPM 12cプロジェクトに移行します。BPM移行ユーティリティで作成される内容は次のとおりです。

- BPM 12cの.expファイル
Oracle BPM StudioまたはOracle Business Process Composerにインポート可能な、エクスポート済のBPM 12c BPMプロジェクト

- 移行レポート
各コンポーネントの移行の詳細が含まれます。移行されなかったコンポーネント、警告およびエラーがリストされます。

BPM移行ユーティリティにより、すべてのマップ可能なプロジェクト・プリファレンス、プロセス設計、互換性のあるカタログ・コンポーネントおよび組織が移行されます。BPM 10gR3の元のプロジェクトと同じ名前と構造を持つBPM 12cプロジェクトが生成されます。

使用方法および必要な引数の詳細は、「BPM移行ユーティリティを使用したプロジェクトの移行」を参照してください。

BPM 10gr3プロジェクトのBPM 12cへの移行は、次の内容で構成されます。

- 設計時アーティファクト
大部分の設計時アーティファクトは、BPM移行ユーティリティによって自動的に移行されます。一部のアーティファクトに対しては、移行を完了するために手動タスクを実行する必要があります。これらのタスクについては、「プロジェクトおよびプロセスの移行の理解」および「カタログの移行の理解」で説明されています。

- 組織
OU移行スクリプトにより、BPM 10gr3の組織は12cの対応するものに自動的に移行されます。「BPM OU移行スクリプトについて」を参照してください。

1.5 BPM 12cアプリケーション

Oracle BPM Suite 12cは、プロセスとタスクのモデル化や実装を行い、それらを実行して管理する次のアプリケーションを備えています。

- Oracle Business Process Management Studio
Oracle BPM StudioはOracle BPM Suiteのコンポーネントの1つです。これを使用すると、プロセス開発者はプロセスベースのアプリケーションを作成して、ビジネス・プロセスをモデル化および実装できます。BPM Studioは、Oracle JDeveloper環境で実行するプラグインとして提供されます。

- Oracle Business Process Composer
Oracle Business Process Composerは、Webベースのコラボレーション・アプリケーションであり、これによって、ビジネス・アナリストはビジネス・プロセスをモデル化し、ビジネス・プロセスで使用されるアーティファクトのいくつかの基本的な実装を行えます。

- Oracle Business Process Management Workspace
Oracle Business Process Management Workspaceはカスタマイズ可能なWebベースのインタフェースであり、タスクおよびプロセス・インスタンスに対するユーザーのロールと責任に応じたアクセスと管理を実現します。

- Oracle Business Process Management Server
Oracle Business Process Management Serverは、ビジネス・プロセスを実行するためのランタイム環境を提供します。BPMN 2.0の両プロセスのネイティブ・サポートも提供します。詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracle BPMNプロセス・サービス・コンポーネントとエンジンの管理に関する項を参照してください。

2 BPM移行ユーティリティ

この章では、BPM 10gR3プロジェクトをBPM 12cに移行する際に使用できるユーティリティについて説明します。

この章の内容は次のとおりです。

- BPM移行ユーティリティについて

- BPM移行ユーティリティがサポートされるプラットフォーム

- BPM移行環境の前提条件

- BPM移行ユーティリティの準備

- BPM移行ユーティリティのオプション

- スクリプト内でのコンポーネントの移行統計の生成

- BPM移行ユーティリティの実行

- BPM移行ユーティリティの出力

- BPM移行ユーティリティの出力へのアクセス

- BPM OU移行スクリプトについて

- BPM OU移行スクリプトの準備

- BPM OU移行スクリプトのオプション

- OU移行スクリプトの実行

2.1 BPM移行ユーティリティについて

Oracle BPM 12cには、移行を容易にする次の2つのユーティリティがあります。

それらは次のとおりです。

- BPM移行ユーティリティ

- BPM OU移行スクリプト

BPM移行ユーティリティは、BPMプロセス、スクリーンフローおよびビジネス・カタログ・アーティファクトを10gR3から12cに移行するAntスクリプトです。これは、12cにインポート可能なBPM 12cエクスポート・プロジェクト・ファイルを作成します。また、移行プロセス時に発生した問題のトラブルシューティングに使用可能な移行ログも作成します。

BPM OU移行スクリプトは、ロールやカレンダ・ルールなどの組織情報をBPM 10gR3環境からBPM 12cに移行するAntスクリプトです。

2.2 BPM移行ユーティリティがサポートされるプラットフォーム

BPM移行ユーティリティは、多くのプラットフォームでサポートされています。

サポートされるプラットフォームは次のとおりです。

- Oracle Enterprise Linux 5.8 (64ビット)

- Oracle Enterprise Linux 6.4 (64ビット)

- Windows 7 Professional (64ビット)

- Windows 8.1 Enterprise (64ビット)

2.3 BPM移行環境の前提条件

BPM 10gR3ソース環境に、BPM移行ユーティリティおよびBPM OU移行スクリプトを実行するための多数のパッケージが含まれている必要があります。

10gR3環境に存在する必要があるパッケージは、次のとおりです。

- Java SE Development Kit
http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

ターゲットのBPM 12cでサポートされるJDKバージョンを使用します。詳細は、http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.htmlの「Oracle Fusion Middleware Supported System Configurations」を参照してください。使用する製品に適した動作保証マトリックスのスプレッドシートをダウンロードします。マトリックスを使用して、プロセッサ、OSバージョンおよびFusion Middleware製品に基づき、BPM 12cターゲットでサポートされるバージョンのJDKを確認します。

詳細は、『Oracle Fusion Middleware SOA SuiteおよびBusiness Process Management SuiteのQuick Start for Developersのインストール』を参照してください。

- Apache Ant (TM)バージョン1.8.4
http://archive.apache.org/dist/ant/binaries/apache-ant-1.8.4-bin.zip

- Oracle Business Process Management Suite 10gR3

- Oracle BPM Studio 12cプラグインを含むJDeveloper 12c。BPM Suiteクイック・スタート・インストーラを使用して、これらのコンポーネントを入手します。http://www.oracle.com/technetwork/middleware/bpm/downloads/index.htmlを参照してください。

移行したプロジェクトを編集、デプロイおよび実行するには、Oracle Business Process Management Suite 12cがインストールされた環境が必要です。Oracle BPM Suiteのインストール方法は、『Oracle Fusion Middleware Oracle SOA SuiteおよびBusiness Process Managementのインストールと構成』を参照してください。

2.4 BPM移行ユーティリティの準備

BPM移行ユーティリティの実行前に、プロジェクトおよび環境が適切に準備されていることを確認する必要があります。

最新バージョンのBPM 10gR3 - 最新のホットフィックス(このガイドの執筆時点ではビルド101298)が適用されたBPM 10gR3 (10.3.3)を使用して、移行するプロジェクトを検証する必要があります

コンパイル・エラーがない - 移行するプロジェクトにコンパイル・エラーがないこと

プロジェクト依存性 - すべての依存プロジェクト(つまり、連携するプロジェクトで、「プロジェクト・プリファレンス」→「依存」→「プロジェクト依存の使用」が選択されている)が同じフォルダ内にあること。

解凍されたファイル名 - 一部の解凍ツールでは、無効な文字を使用すると、解凍されたファイル名が正しく表示されません。必ずBPM Studio 10gR3を使用して、インポートしたプロジェクトの.expファイルを展開します。マイグレータ・プロジェクトの場所パラメータで、BPM Studio 10gR3によって作成されたプロジェクト・ルート・フォルダを指し示す必要があります。たとえば、C:\OracleBPM\SampleProjectなどです。

英語以外の文字 - 無効な文字として表示される外国語文字('?'と表示される'è'など)を英語の代用文字('e'など)で置き換えます。BPMファイル・メタデータ内の英語以外の文字は受け入れられます。

BPM 5.5および5.7ファイルのメタデータ - BPM移行ツールでは、特定のファイル(.xpdlファイルや.xsdlファイルなど)内のBPM 5.xメタデータをサポートしません。Antコンソールの出力や移行レポートは、これらのファイルの名前を表します。ファイルのメタデータを更新するには、BPM Studio 10gR3を使用して、影響を受けるファイルを編集し、重要ではない変更をアクティビティに加えて(わずかに移動するなど)、プロジェクトを保存します。

ファイルの無効なメタデータによる移行レポートのエラー・メッセージの例を次に示します。

SEVERE: path/to/process_name.xpdl is a legacy file format and cannot be processed. Only 10.3 format is supported. In order to migrate it please edit and save the file (Process, Screenflow or Procedure) using Studio 10.3, export the project and re-run the migration.

列挙 - BPM移行ユーティリティを実行する際に特定のAntパラメータを使用して、イントロスペクトされたjar内で指定された列挙を指定する必要があります。次に例を示します。

ant -lib myenum.jar mgrate10-12...

Plumtree - Plumtreeコンポーネントをスクリプトで使用する場合、ant -libパラメータを使用して、配布されたedk jar (fuego.edk-10.3.3.jar)の場所を指定します。次に例を示します。

ant -lib route/to/fuego.edk-10.3.3.jar migrate10-12...

Webサービス - Webサービス内のコールされたWebサービス(.wsdlファイル)にアクセスできることを確認します

スキーマ - スキーマ・ファイル内のコールされたxmlスキーマ(.xsdファイル)にアクセスできることを確認します

2.5 BPM移行ユーティリティのオプション

この項では、BPM移行ユーティリティのコマンド行オプションについて説明します。

BPM移行ユーティリティのコマンド行の構文は次のとおりです。

ant migrate10-12 -DprojectLocation=<source> -Ddestination=<target> [-Doption=-L<log_level>] [-DcustomXMLmappingDirs=<mappingdirs>]

それぞれの意味は次のとおりです。

- source - 移行するBPM 10gR3プロジェクトの場所を指定します

- target - 移行するプロジェクトとレポート・ファイルの宛先

- log_level - ログとして記録するメッセージの詳細レベル。指定したレベル以上のメッセージをログとして記録します。ログ・レベルを指定しない場合、デフォルトのレベルは-L2です。これは、L2、L3、L4およびL5のメッセージのログを記録します。
ログ・レベルは次のとおりです。

- -L1: 詳細な情報メッセージ

- -L2: 情報メッセージ

- -L3: 警告メッセージ

- -L4: 重大な問題メッセージ

- -L5: 致命的なエラー・メッセージ

- mappingdirs - Business Process Languageスクリプトの移行時に使用するカスタムXMLマッピングを含むディレクトリのリスト。:で区切ります。たとえば、dir1:dir2:dirnのようになります。
コマンド行呼出しの例を示します。

ant migrate10-12 -DprojectLocation=/user/migrationTests/input/samples/ExpenseReimbursement -Ddestination=/user/migrationTests/output/samples/export1

出力の詳細を取得するには、ant -dおよび-vコマンド行パラメータと、比較的高いログ・レベルを使用します。

ant -d -v migrate10-12 -DprojectLocation=/user/migrationTests/input/samples/ExpenseReimbursement -Ddestination=/user/migrationTests/output/samples/export2 -Doption=-L1

不正なコマンド行引数を使用してBPM移行ユーティリティを実行すると、ターミナルにUSAGE文が出力されます。この文は、USAGE文に含める必要のある内容と、使用する必要のある表記規則を説明しています。次に例を示します。

ant migrate10-12 -DprojectLocation=source -Ddestination=target (-Doption="options") (-DcustomXMLmappingDirs=customXmlDirs)

antパラメータを使用した移行統計の生成の詳細は、「スクリプト内でのコンポーネントの移行統計の生成」を参照してください。

2.6 スクリプト内でのコンポーネントの移行統計の生成

スクリプトで使用されるコンポーネントの移行統計を生成できます。

スクリプトで使用されているコンポーネントの移行統計を生成するには、BPM移行ユーティリティを実行する前に、パラメータ-Doracle.bpm.migration10to12.statistics=trueをANT_OPTS環境変数に追加します。

このパラメータにより、BPM移行ユーティリティの出力パスに<project_name>_mapperStats.csvというCSVファイルが作成されます。

このファイルには、次の列があります。

- ソース
返される値: 事前定義済コンポーネント、ユーザー定義コンポーネント

- コンポーネント
コンポーネントの完全な名前が指定されます。

- コンポーネント・タイプ
使用されているテクノロジが指定されます。

- メンバー・タイプ
返される値: タイプ、メソッド、属性(読取り、書込み)

- 数量
コンポーネントの相対的使用状況が示されます。

2.7 BPM移行ユーティリティの実行

BPM移行ユーティリティを使用して、BPM 10gR3バージョンからBPM 12cにプロジェクトを移行します。

環境および前提条件の詳細は、「BPM移行ユーティリティがサポートされるプラットフォーム」および「BPM移行環境の前提条件」を参照してください。

BPM移行ユーティリティの実行前に行う手順については、「BPM移行ユーティリティの準備」を参照してください。

BPM移行ユーティリティの実行手順

1. コマンド行(LINUX)またはコマンド・プロンプト(Windows)にアクセスします。

2. $JDEV_HOME/soa/plugins/jdeveloper/bpm/にナビゲートします

3. BPM移行ユーティリティを次のように実行します。ant migrate10-12 -DprojectLocation=<source> -Ddestination=<target> [-Doption=-L<log level>] [-DcustomXMLmappingDirs=<mappingdirs>
例: ant migrate10-12 -DprojectLocation=/home/myUser/OracleBPMWorkspace/Sample103Project -Ddestination=/home/myUser/migTests/FirstTest

BPM移行ユーティリティのパラメータとオプションの詳細は、「BPM移行ユーティリティのオプション」を参照してください。

注意:
移行先ユーティリティは存在していない必要があります。すでに移行済のプロジェクトへの上書きを回避するために、移行先ディレクトリが存在している場合は、BPM移行ユーティリティは稼働しません。

4. 出力ディレクトリに移動して、次のファイルがあることを確認します。

- 移行したプロジェクト・ファイル: 移行したプロジェクトと同じ名前に.exp拡張子が付加されたファイル

- 移行レポート: 移行したプロジェクトと同じ名前の2つのファイル。一方の拡張子は.xml、もう一方の拡張子は.xsl

BPM移行ユーティリティの実行後、プロセスがBPM 12cに移行されます。

BPM移行ユーティリティによって、エクスポートされたBPMプロジェクトが作成され、Oracle Business Process Management 12cでこれを開くことができます。

BPM移行ユーティリティがBPMプロジェクトの各要素をどのように移行するかの詳細な説明は、次を参照してください。

- Business Process Languageの移行の理解

- カタログの移行の理解

移行レポートの表示方法の詳細は、「BPM移行ユーティリティの出力へのアクセス」を参照してください。

2.8 BPM移行ユーティリティの出力

BPM移行ユーティリティでは、その実行時にターゲット・ディレクトリにいくつかのファイルが作成されます。

プロジェクトmyprojectがターゲット・ディレクトリmigrateoutputに移行されると、次のファイルが作成されます。

- myproject.exp - BPM 12c形式の移行済プロジェクト・ファイル

- myproject.xml - 移行レポート・データ

- report.xsl - 移行レポート形式のスキーマ

- myproject_mapperStats.csv - (オプション)カンマ区切りの統計ファイル

- myproject_projectStats.csv - (オプション)カンマ区切りの統計ファイル

BPM移行ユーティリティのパラメータの詳細は、「BPM移行ユーティリティのオプション」および「スクリプト内でのコンポーネントの移行統計の生成」を参照してください。

2.9 BPM移行ユーティリティの出力へのアクセス

BPM移行ユーティリティでは移行レポートが生成され、このレポートに、移行処理の結果の説明と、ソースBPMプロジェクトの各アーティファクトの移行ステータスが示されます。このレポートを使用して、移行を完了するために手動で追加変更する必要がある箇所を把握します。

移行レポートを表示する手順は、次のとおりです。

1. BPM移行ユーティリティを実行したときに-Ddestinationで指定したターゲット・ディレクトリに移動します。

2. Webブラウザで、移行したプロジェクトと同じ名前に.exp拡張子が付加されたファイルを開きます。

移行レポートの詳細は、「BPM移行ユーティリティの移行レポートの理解」を参照してください。

2.10 BPM OU移行スクリプトについて

BPM組織単位(OU)移行スクリプトを使用して、BPM 10gR3からBPM 12cにアーティファクトを移行します。

OU移行スクリプトにより移行されるアーティファクトは、次のとおりです。

- 組織単位

- カレンダ・ルール

- 休日ルール

- アプリケーション・ロール

- パラメータ・ロール

- ビジネス・パラメータ

2.11 BPM OU移行スクリプトの準備

BPM OU移行スクリプトを実行する前に、いくつかの準備タスクを実行する必要があります。

作業フォルダ - スクリプトの実行時に使用する作業フォルダを作成します

作業フォルダへのdirectory.xmlのコピー - Oracle/Middleware/<Oracle_Home>/soa/plugins/migration/bpmに移動して、directory.xmlをコピーします。このファイルのコピーを作業フォルダに置きます。

directory.xmlの構成 - directory.xmlを編集して、サーバーと接続の情報を次のように指定する必要があります。

- localhostをSOA/BPM 12cサーバーのIPアドレスに、ポート番号7001をSOA/BPM 12cサーバーのポート番号に置き換えて、<serverURL>t3://localhost:7001</serverURL>行を編集します。

- <admin>属性を編集して、10gR3 WebLogicサーバー管理アカウントのユーザー名を指定します

- <adminPass>属性を編集して、10gR3 WebLogicサーバー管理アカウントのパスワードを指定します

作業フォルダへのorganizationmigrationファイルの解凍 - $BPM_HOME/ou-migrationに移動して、oracle.bpm.bpm-services.organizationmigration.jarを作業フォルダに解凍します。

BPM 10gR3コンポーネントの実行 - BPM 10gディレクトリ・サービス・データベース(Fuego Directory Interface (FDI))およびLDAPサーバーが実行している必要があります

BPM 12cの実行 - BPM 12c環境が稼働している必要があります

12c_Config.xmlの構成 - (Oracle/Middleware/<Oracle_Home>/soa/plugins/migration/bpmにある) 12c_Config.xmlを編集して、次のようにサーバーおよび接続情報を指定します。

- localhostをSOA/BPM 12cサーバーのIPアドレスに、ポート番号7001をSOA/BPM 12cサーバーのポート番号に置き換えて、<serverURL>t3://localhost:7001</serverURL>行を編集します。

- <adminUserLogin>属性を編集して、12c WebLogicサーバー管理アカウントのユーザー名を指定します

- <adminUserPassword>属性を編集して、12c WebLogicサーバー管理アカウントのパスワードを指定します

LDAP接続性 - BPM 10gR3 LDAPサーバーと接続できるようにSOA/BPM 12c環境を構成します。

2.12 BPM OU移行スクリプトのオプション

この項では、BPM組織単位(OU)移行スクリプトのコマンドライン・オプションについて説明します。

BPM OU移行スクリプトのコマンド行の構文は次のとおりです。

ant -f ant-organization-migrator.xml -Dfmwhome=<path_to_fmwhome> -Dalbpm.directory.file=<path_to_10g_directory_xml> -Dconfig.file=<path_to_12c_configfile_xml> -Dfuegojarpath=<path_to_10g_fuego> -Dentity.type=<entity> [-Dversion=<target_jar_version>

それぞれの意味は次のとおりです。

- path_to_fmwhome - BPM 12c fmwhomeディレクトリのパスを指定します

- path_to_10g_directory_xml - BPM 10gR3のdirectory.xmlファイルの場所を指定します。これは、ファイルのコピーを置いた作業フォルダになります。

- path_to_12c_configfile_xml - BPM 12cの12c_configfile.xmlファイルの場所を指定します。このファイルは、BPM 12cサーバーとログイン情報を指定するように編集する必要があります。「BPM OU移行スクリプトの準備」を参照してください。

- path_to_10g_fuego - BPM 10gR3のfuegopapi.client-10.3.3.jarファイルのパス。このファイルは、通常Oracle/Middleware/<Oracle_Home>/soa/plugins/jdeveloper/bpm/librariesにあります

- entity - 移行する組織要素を指定します。可能な値は、calendar、orgunit、approle、parametricroleおよびallです。このパラメータを空白のままにする場合、値allが使用されます。

- target_jar_version - オプション。ターゲットの12cバージョン(12.1.3など)を指定します。指定しない場合、デフォルトは12.1.3です。

カレンダ・ルールのみを移行するコマンド行呼出しの例を示します。

ant -f ant-organization-migrator.xml -Dfmwhome=/oracle/fmwhome -Dalbpm.directory.file=/mytempworkingfolder -Dconfig.file=/oracle/product/middleware/oracle_home/soa/plugins/migration/bpm -Dfuegojarpath=OraBPMStudioHome/client/papi/lib -Dentity.type=calendar

不正なコマンド行引数を使用してBPM移行ユーティリティを実行すると、ターミナルにUSAGE文が出力されます。この文は、USAGE文に含める必要のある内容と、使用する必要のある表記規則を説明しています。

2.13 OU移行スクリプトの実行

BPM組織単位(OU)移行スクリプトを使用して、BPM 10gR3からBPM 12cに組織単位アーティファクトを移行します。

環境および前提条件の詳細は、「BPM OU移行スクリプトについて」および「BPM移行環境の前提条件」を参照してください。

OU移行スクリプトの実行前に行う手順については、「BPM OU移行スクリプトの準備」を参照してください。

OU移行スクリプトを実行する手順:

1. コマンド行(LINUX)またはコマンド・プロンプト(Windows)にアクセスします。

2. $JDEV_HOME/soa/plugins/jdeveloper/bpm/にナビゲートします

3. OU移行スクリプトを実行します。

ant -f ant-organization-migrator.xml -Dfmwhome=<path_to_fmwhome> -Dalbpm.directory.file=<path_to_10g_directory_xml> -Dconfig.file=<path_to_12c_configfile_xml> -Dfuegojarpath=<path_to_10g_fuego> -Dentity.type=<entity> [-Dversion=<target_jar_version>

次に例を示します。

ant -f ant-organization-migrator.xml -Dfmwhome=/oracle/fmwhome -Dalbpm.directory.file=/mytempworkingfolder -Dconfig.file=/oracle/product/middleware/oracle_home/soa/plugins/migration/bpm -Dfuegojarpath=OraBPMStudioHome/client/papi/lib -Dentity.type=calendar

OU移行スクリプトのパラメータとオプションの詳細は、「BPM OU移行スクリプトのオプション」を参照してください。

OU移行スクリプトは、組織単位の要素をターゲットのBPM 12c環境に移行して作成します。

OU移行スクリプトの呼出し元となった場所に、migr_report.xmlというXML移行レポートが作成されます。このレポートには、移行が成功した要素と失敗した要素、および移行の失敗の理由が示されます。

3 BPM移行ユーティリティを使用したプロジェクトの移行

この章では、BPM移行ユーティリティおよびOU移行スクリプトからの出力を使用してOracle BPM 10gR3プロジェクトをOracle BPM 12cに移行する方法に関する高度な情報を提供します。

この章の内容は次のとおりです。

- BPMプロジェクトの移行の概要

- 移行ユーティリティの実行

- BPM移行ユーティリティの移行レポートの理解

- 移行統計の理解

3.1 BPMプロジェクトの移行の概要

BPM移行ユーティリティを使用すると、Oracle BPM 10gR3プロジェクトをOracle BPM 12cプロジェクトに移行できます。

BPM移行ユーティリティによって、エクスポートされたBPMプロジェクト・ファイルと移行レポート、およびマッパーやプロジェクト統計の.csvファイルが作成されます。移行レポートには、BPMプロジェクトの各要素の移行の詳細が含まれます。移行中に問題が発生した場合、BPM移行ユーティリティは、問題の詳細ログを移行レポートに記録します。

移行の大部分は自動的に行われますが、一部のプロジェクト要素では、移行を完了するために、BPM移行ユーティリティを使用して作成されたBPM 12cプロジェクトで変更を加える必要があります。このガイドでは、どのプロジェクト要素に対して手動の移行作業が必要かを説明する詳細情報を記載します。

3.2 移行ユーティリティの実行

BPM 12cには、BPM移行ユーティリティ(プロジェクトの移行)とOU移行スクリプト(組織単位情報の移行)の2つのコマンド行ユーティリティがあります。

BPM移行ユーティリティでは、BPM 12cにインポート可能なBPM 12cプロジェクトのエクスポート・ファイルと、移行を完了するために問題のトラブルシューティングや手動による追加手順が必要な領域の特定に使用可能な移行レポートが作成されます。

注意:

プロジェクトを移行すると、既存のすべての11gプロジェクトがBPM移行ユーティリティのコマンド行で定義するターゲットの場所に配置されます。既存の11gプロジェクトには、新しい権限BPMPAMDEFAULTGROUP/Noneが付与されます。権限がNoneであるため、プロジェクトは引き続きプライベートになります。

ただし、ターゲットの場所に新しいプロジェクトを作成すると、そのプロジェクトはEditor権限を持つ移行グループBPMPAMDEFAULTGROUPで共有されます。ターゲットの場所で新しいプロジェクトをプライベートにするには、プロジェクト権限をBPMPAMDEFAULTGROUP/EditorからBPMPAMDEFAULTGROUP/Noneに変更します。

OU移行スクリプトは、組織単位、カレンダ・ルールと休日ルール、ロールおよびビジネス・パラメータを移行します。

これらのユーティリティでは、移行できなかった要素と失敗の理由を示すレポートも作成されます。ターゲット・システムで問題の修正や要素の手動による再作成を行うには、手動の操作が必要になります。

ユーティリティにより実行される処理、ユーティリティの前提条件、およびその実行方法の詳細は、「BPM移行ユーティリティについて」を参照してください。

3.3 BPM移行ユーティリティの移行レポートの理解

BPM移行ユーティリティでは、ターゲット・ディレクトリに移行レポートが作成されます。

移行レポートの名前は、移行したプロジェクトの名前に.exp拡張子が付加されたものです。次の情報が含まれます。

- 日付
最初の行には、BPM移行ユーティリティが実行された日付を示すタイムスタンプが含まれています。

- ビジネス・カタログ移行メッセージ
最初のメッセージは、ビジネス・カタログ内の各アーティファクトの移行を説明しています。

- プロセス設計移行メッセージ
プロセス設計移行メッセージは、ソースBPM 10gR3プロジェクトに含まれているプロセス設計の各アーティファクトの移行を説明しています。

メッセージは次のカテゴリでタグ付けされています。

- INFO
アーティファクトの移行が成功したことを示します。

- WARNING
アーティファクトを移行の際に制限が検出されたことを示します。

- SEVERE
アーティファクトの特定の機能が移行されなかったことを示します。

- FATAL
アーティファクトの移行を妨げた問題を説明しています。また、移行プロセスが完了しなかったことを表しています。

詳細は、「BPM移行ユーティリティのオプション」を参照してください。

3.4 移行統計の理解

BPM移行ユーティリティにより、BPMアーティファクトの移行ステータスに関する情報を含むレポートが生成されます。このレポートでは、元の10gR3ビジネス・カタログに含まれているすべてのタイプに関する情報を提供しているため、より多くの用途のタイプがわかります。この情報を使用して、BPM移行ユーティリティの制限を考慮に入れながら移行の計画を立てます。

BPM移行ユーティリティでは、デフォルトでレポートが生成されます。コマンド行のスイッチやパラメータは必要ありません。

レポートには、BPMプロセスおよびビジネス・カタログについて、次の情報が含まれます。

- アーティファクト・タイプ

- アーティファクト・タイプの名前

- 10gr3プロジェクトにおける出現数

移行ユーティリティにより、この情報が.csvファイルに保存されます。ファイル名はプロジェクト名に接尾辞_projectStatsを付加して構成され、.csv拡張子を持ちます。

このレポートには次の列が含まれます。

- グループ
コンポーネントのグループを示します。例: CATALOG

- 要素
グループ内の特定のコンポーネントを示します。例: SQL (CATALOGグループの一部)

- 数量
プロジェクト内での使用状況を示します。

レポートを表示する際、次の点を考慮に入れてください。

- Webサービスの使用状況はポート・タイプではなくWSDLによって数えられます

- 列挙はXMLとNO-XMLに分けられています。
XML: XMLスキーマからインポート

NO-XML: 手動で作成

- プレゼンテーションが個々に数えられます

- XMLタイプが個々に数えられます。
次の例では、不明な数のスキーマによって合計4タイプが定義されています。

レポートの例

グループ

要素

数量

カタログ・コンポーネント

ビジネス・オブジェクト例外

1

カタログ・コンポーネント

Webサービス

1

カタログ・コンポーネント

XML列挙

1

カタログ・コンポーネント

CUnitスイート

1

カタログ・コンポーネント

ビジネス・オブジェクト・プレゼンテーション

3

カタログ・コンポーネント

BPMオブジェクト

3

カタログ・コンポーネント

PUnitスイート

1

カタログ・コンポーネント

列挙

1

カタログ・コンポーネント

XMLタイプ

4

カタログ・コンポーネント

モジュール

2

プロセス・モデリング

プロセス・モデリング・グループには次の要素が含まれます。

- すべてのタイプのプロセス
含まれるもの: スクリーンフロー、プロセス、プロシージャ、レイン

- アクティビティ
含まれるもの: メソッド、コンポーネントおよびプロシージャで実装された対話型アクティビティと自動アクティビティの両方

- 遷移
含まれるもの: 無条件、期限、期限スケジュール、補正型、メッセージ・ベース、依存、すべて、ビジネス・ルール、例外および条件付き推移

- その他
Webリソース、ビュー、カスタムJSPおよびプレゼンテーションが含まれます。

4 プロジェクトおよびプロセスの移行の理解

この章では、プロジェクト・アーティファクトおよびBPMプロセス・コンポーネントの移行について説明します。

この章の内容は次のとおりです。

- プロジェクト・アーティファクトの移行

- BPMアクティビティの移行

- 遷移の移行

- 例外の移行

- 引数および引数マッピングの移行

4.1 プロジェクト・アーティファクトの移行

BPM移行ユーティリティにより、次の表に示すマッピングを使用してBPMプロジェクトのアーティファクトが移行されます。

表4-1 プロジェクト・アーティファクトのマッピング

10gr3アーティファクト

12cアーティファクト

プロジェクトのプロパティ

構成済言語のみ移行されます。

言語

「プロジェクト」プリファレンス内の「言語」プリファレンスに移行されます。

現在の言語

「プロジェクト」プリファレンス内の「現在の言語」プリファレンスに移行されます。

プロジェクト変数

プロジェクト・データ・オブジェクト

ビジネス・インジケータ

ビジネス・インジケータ

プロセス変数

プロセス・データ・オブジェクト

プロセスのプロパティ

「イベントの生成」および「作成者」プロパティが移行されます。

プロシージャ

BPMNプロセス

ドキュメント

i18nプロセスのドキュメントを移行します。

イメージ、フォント・タイプ、フォント・スタイル(太字、イタリック、下線など)およびフォント色は移行されません。

組織

BPMNプロセスで使用されているロールが移行されます。

レーン

レーン

レイアウト

移行はサポートされていません。BPM 12cでは自動レイアウトが使用されます。

シミュレーション・モデル

移行はサポートされていません。

プレゼンテーション

移行されません

プロジェクトの依存性

プロジェクトの依存性およびベース・プロジェクト・プロパティは移行されません。

カタログおよびロールの移行では、プロジェクトの依存がサポートされています。この機能を使用するには、ベース・プロジェクトを、依存プロジェクトの保存先と同じディレクトリにコピーする必要があります。

4.2 BPMアクティビティの移行

BPM移行ユーティリティでは、次の各項で説明するマッピングを使用してBPMプロセスのアクティビティが移行されます。

- イベントの移行

- アクティビティの移行

- ゲートウェイの移行

- その他のプロセス・アーティファクトの移行

BPMアクティビティを移行する際の制限事項および既知の問題の詳細は、「BPMアクティビティの移行における既知の問題」を参照してください。

4.2.1 イベントの移行

BPM移行ユーティリティでは、次のマッピングを使用して、イベントがBPM 10gr3プロセスからBPM 12cプロセスに移行されます。

表4-2 BPM 10gr3アクティビティからBPM 12cへのイベントのマッピング

10gr3アーティファクト

12cアーティファクト

Begin

メッセージ・キャッチの開始イベント。beginイベントに複数の引数セットが含まれている場合、複数のBPMNメッセージ開始イベント(引数セットごとに1つ)に移行されます。詳細は、「引数および引数マッピングの移行」を参照してください。

End

終了イベント。

引数および引数マッピングの移行の詳細は、「引数および引数マッピングの移行」を参照してください。

境界イベント

アクティビティのみ境界イベントをサポートしています。BPMNイベントとして移行されるアーティファクト内の境界イベントは移行されません。

「遷移の移行」を参照してください。

中断を許可するメッセージ待機

メッセージ開始イベントを持つイベント・サブプロセス。

場合によっては、中断を許可する通知待機はマッピングがないこともあります。通知待機に複数のアウトバウンド推移が存在する場合は、複数のイベント・サブプロセスにマッピングされます。

「引数および引数マッピングの移行」を参照してください。

中断を許可しないメッセージ待機

キャッチ・メッセージ・イベント。

場合によっては、中断を許可しない通知待機はマッピングがないこともあります。通知待機に複数の引数セットがある場合、ユーティリティによる移行では各引数セットについて別々のキャッチ・イベントが作成されます。

「引数および引数マッピングの移行」を参照してください。

メッセージの送信

中間メッセージ・スロー・イベント

タイマー

中間タイマー・キャッチ・イベント

補正

実装なしの抽象アクティビティとして移行されます。実装方法を決定するか、削除する必要があります。

ランタイム設定

詳細設定

カスタム・イメージ

移行されません。

4.2.2 アクティビティの移行

BPM移行ユーティリティでは、次のマッピングを使用して、アクティビティがBPM 10gr3プロセスからBPM 12cプロセスに移行されます。

表4-3 BPM 10gr3アクティビティからBPM 12cアクティビティへのマッピング

10gr3アーティファクト

12cアーティファクト

実装なしの自動

抽象アクティビティ

コンポーネントが実装された自動

サービス・タスク

メソッドが実装された自動

スクリプト・タスク

プロシージャが実装された自動

プロセス・コールが実装されたサービス・タスク。引数および引数マッピングは移行されます。

ループのある自動

ループ条件、評価順序および条件は移行されません。

実装なしの対話型

空のヒューマン・タスクが実装されたユーザー・タスク。

移行を完了するには、ヒューマン・タスクを実装する必要があります。

スクリーンフローを起動する対話型

プロセス・コールが実装されたサービス・タスク。

サービス・タスクがロール定義をサポートするのではなく、ロールの割当てはプロセスに含まれるため、元のロールが移行後に変更されても構いません。

次のものが実装された対話型:

- コンポーネント

- メソッド

- 外部

- 入力

- 表示

空のヒューマン・タスクが実装されたユーザー・タスク。

移行を完了するには、ヒューマン・タスクを実装する必要があります。

オプションのタスクが含まれる対話型

移行されません。

PUnitタスクが含まれる対話型

移行されません。

デシジョン

空のヒューマン・タスクが実装されたユーザー・タスク。

移行を完了するには、ヒューマン・タスクを実装する必要があります。

対話型コンポーネント・コール

空のヒューマン・タスクが実装されたユーザー・タスク。

移行を完了するには、ヒューマン・タスクを実装する必要があります。

次のものが実装された対話型コンポーネント・コール:

- コンポーネント

- 入力

- 表示

- BPMオブジェクト対話型コール

空のヒューマン・タスクが実装されたユーザー・タスク。

移行を完了するには、ヒューマン・タスクを実装する必要があります。

グループ

埋込みサブプロセス

BPM 10gr3のトランザクション・プロパティにはマッピングがありません。

サブフロー

実装のない抽象アクティビティ。アクティビティ名には、識別のために接尾辞"was screenflow"が付けられます。実装方法を決定する必要があります。

引数および引数マッピングの移行の詳細は、「引数および引数マッピングの移行」を参照してください。

スクリーンフロー

BPMNプロセス

サブスクリーンフロー

プロセス・コールが実装されたサービス・タスク。動的プロセス起動はサポートされていません

プロセス作成

実装なしの送信タスク。動的プロセス起動はサポートされていません。

ランタイム設定は移行されません。

終了待機

実装なしの受信タスク。

ランタイム設定は移行されません。

取得

移行は必要ありません。フローの変更機能は、すべてのBPMプロセスについて、プロセス・ワークスペースから使用できます。

実装なしの抽象アクティビティに移行されます。このアクティビティはプロセス・フローに接続されていません。

すべて取得

移行は必要ありません。フローの変更機能は、すべてのBPMプロセスについて、プロセス・ワークスペースから使用できます。

グローバル作成

実装なしの開始イベント、次に実装の定義されていないイニシエータ・ユーザー・タスクへのデフォルト・シーケンス・フローが続き、さらにデフォルト・シーケンス・フローが続きます。

グローバル作成アクティビティにスクリプトが含まれている場合、スクリプトが含まれるスクリプト・タスクは、最後のデフォルト・シーケンス・フローの後に追加されます。

グローバル作成アクティビティがスクリーンフローを起動する場合、移行されたスクリーンフローを呼び出すサービス・タスクは、最後のデフォルト・シーケンス・フローの後に追加されます。

自動完了および実行時設定は移行されません。

グローバル自動

開始イベントの後にスクリプト・タスクとタイプNoneの終了イベントが続きます。ランタイム設定は移行されません。

グローバル自動|間隔ごとのポーリング

タイマー開始イベント。

グローバル自動 - イベントによるトリガー

メッセージ開始イベント。

グローバル自動 - 自動スケジュール

メッセージ開始イベント。

グローバル自動 - JMSリスナー

メッセージ開始イベント。

グローバル自動 - JMS/JMX

メッセージ開始イベント。

グローバル対話型

移行されません。

ランタイム設定

詳細設定

カスタム・イメージ

移行されません。

4.2.3 ゲートウェイの移行

BPM移行ユーティリティでは、次のマッピングを使用して、ゲートウェイがBPM 10gr3プロセスからBPM 12cプロセスに移行されます。

表4-4 BPM 10gr3アクティビティからBPM 12cへのゲートウェイのマッピング

10gr3アーティファクト

12cアーティファクト

条件ゲートウェイ

排他ゲートウェイ

分割

パラレル・ゲートウェイ。

「コピーの生成」プロパティは移行されません。

OR分割

包含ゲートウェイ。

複数のゲートウェイ

複数インスタンス・サブプロセス。

移行を手動で完了する必要があります。詳細は、「複数のゲートウェイの移行の理解」を参照してください。

4.2.3.1 複数のゲートウェイの移行の理解

BPM移行ユーティリティでは複数のゲートウェイを、次の特性を持つ複数インスタンス・サブプロセスに移行します。

- 複数インスタンス・サブプロセスのタイプはパラレルです。

- ループ特性タブはループ・カーディナリティが選択済で、単純な式が実装されています。移行処理を確認すると、警告が表示され、複数インスタンス実装の式を完了するように求められます。

複数のゲートウェイがある場合、移行を完了するために、手動で追加の手順を実行する必要があります。詳細は、「複数のゲートウェイの移行の完了」を参照してください。

4.2.3.2 複数のゲートウェイの移行の完了

BPM移行ユーティリティの実行後、次のものを実装または適応することにより、複数のゲートウェイの移行を手動で完了する必要があります。

- ループ特性

- 作成タイプ

- 式およびスクリプト

マルチインスタンス・サブプロセスを使用してBPM 10gr3機能をレプリケートする手順は、次のとおりです。

1. 必要な値または式を設定します。

2. Split-Nに同時コピーが構成されている場合はt1'を設定し、その後、複数インスタンス・サブプロセスをパラレルではなくシーケンシャルとして構成します。

3. サブプロセスで変数を作成し、プロセスの変数にマッピングします。

4. マッピングの動作を維持できるようにスクリプト・コードを編集します。

5. 複数のゲートウェイでデータ・オブジェクトが使用されている場合、すべてのコピー・インスタンスを移行します。

6. BPM 10gr3プロセスに、スクリプトが実装された分割/結合アクティビティが含まれている場合、スクリプト・タスクを12cプロセスの最初および最後のフロー・オブジェクトとして追加します。その後、スクリプト実装を移行します。移行ユーティリティにより、スクリプト実装はコメントとして移行されるため、BPM 10gr3実装に基づいて新しいスクリプトを作成できます。

4.2.4 その他のプロセス・アーティファクトの移行

移行ユーティリティでは、次のマッピングを使用して、プロセス・アーティファクトがBPM 10gr3プロセスからBPM 12cプロセスに移行されます。

表4-5 BPM 10gr3アクティビティからBPM 12cへのプロセス・アーティファクトのマッピング

10gr3アーティファクト

12cアーティファクト

レーン

BPMNレーン

メモ

テキスト注釈。

プロセス構造が異なるため、メモの場所が変更されます。移行を完了するには、メモを移動する必要があります。

測定マーク

移行されません。

ドキュメント

プロセス・メモ・ドキュメントおよびプロセス・メモ・ユースケース・ドキュメントは、12cの同じアーティファクトに移行されます。イメージおよびフォント・タイプ、フォント・スタイルおよびフォント色はサポートされていません。

フォルダ

プロセスまたはスクリーンフローが含まれているフォルダは、12c BPMプロジェクトのフォルダに移行されます。

ビジネス・ルール

移行されません。

プロセス・インタフェース

移行されません。

4.3 遷移の移行

BPM移行ユーティリティでは、次のマッピングを使用して、BPM 10gr3の遷移がBPM 12cのシーケンス・フローに移行されます。

表4-6 BPM 10gr3の遷移からBPM 12cのシーケンス・フローへのマッピング

10gr3アーティファクト

12cアーティファクト

無条件推移

デフォルト・シーケンス・フロー。

条件推移

BPMNゲートウェイおよび条件シーケンス・フローとして移行されます。

式が12cの単純な式でサポートされている場合、条件は移行されます。そうでない場合、条件は単純な式のコメントとして表示されます。

期限推移

割込み境界タイマー・イベントを持つシーケンス・フロー。

詳細は、「期限推移の移行の理解」を参照してください。

メッセージ推移

デフォルト・シーケンス・フロー。

例外推移

デフォルト・シーケンス・フローを持つキャッチ・エラー境界イベント。

ビジネス・ルール推移

条件が空の条件シーケンス・フロー。

詳細は、「ビジネス・ルール推移の移行の理解」を参照してください。

補正型推移

移行されません。

4.3.1 期限推移の移行の理解

BPM移行ユーティリティにより、期限推移は、キャッチ・タイマー境界イベントとそれに続くデフォルト・シーケンス・フローに移行されます。

期限推移に間隔式または定数式が含まれている場合、この式はBPM 12cでサポートされている式と互換性がある必要があります。式に互換性がない場合、メッセージ・エラーが表示され、移行を完了するためには手動で修正する必要があります。

間隔式および定数式のみ移行されます。

4.3.2 ビジネス・ルール推移の移行の理解

BPM移行ユーティリティにより、各ビジネス・ルール推移は、空の条件を持つ条件シーケンス・フローに移行されます。

BPM 10gr3ビジネス・ルールのコードが空の条件内にコメントとして表示されるため、これを使用して新しいビジネス・ルールを手動でコーディングできます。詳細は、「ビジネス・ルール推移の移行の完了」を参照してください。

4.3.3 ビジネス・ルール推移の移行の完了

ビジネス・ルール推移は、空の条件を持つ条件シーケンス・フローとして移行されます。空の条件にBPM 10gr3からのコメント付きコードが含まれるため、これを新しい実装のガイドとして使用できます。

移行ユーティリティを使用してビジネス推移を移行した後、ビジネス・ルールを手動でコーディングし、それを使用できるように条件シーケンス・フローの条件を構成する必要があります。

4.4 例外の移行

BPM移行ユーティリティでは、次のマッピングを使用して例外処理を移行します。

表4-7 BPM 10gr3の遷移からBPM 12cのシーケンス・フローへのマッピング

10gr3アーティファクト

12cアーティファクト

例外推移

デフォルト・シーケンス・フローを持つエラー・キャッチ境界イベント。

プロセス例外

BPMNイベント・サブプロセス。

各例外推移は、別々のイベント・サブプロセスに移行されます。

補正

割込み境界タイマー・イベントを持つシーケンス・フロー。

スキップおよび戻るアクション

スキップおよび戻るアクションは、事前定義済変数アクションを使用してサポートされています。詳細は、『Oracle Business Process Management Studioでのビジネス・プロセスの開発』の例外からの復帰のためのキャッチ・イベントの構成に関する項を参照してください。

4.5 引数および引数マッピングの移行

BPM移行ユーティリティでは、次のアーティファクトの引数および引数マッピングを移行します。

- Begin

- End

- メッセージ待機

- スクリーンフロー・コールが実装された対話型

- サブフロー

BPM 10gr3の引数はBPM 12cの引数に移行されます。BPM 10gr3の引数マッピングは、BPM 12cのデータ・アソシエーションに移行されます。

移行ユーティリティでは、これらの引数で使用されている変数、式およびデータ型がBPM 12cでサポートされている場合、またはBPM 12cに対応するものが存在する場合のみ、引数が移行されます。

スクリーンフロー・コールが実装されている対話型アクティビティの場合、移行ユーティリティによってメイン・タスクの入力/出力引数が使用されます。

複数の引数セットはBPMNでサポートされていません。一部の特殊の場合は、複数の引数セットは同じ状況のモデルを持つ異なる構造にマッピングされます。詳細は、「BPMアクティビティの移行」内の開始アクティビティおよび中断を許可する通知待機アクティビティを参照してください。

5 カタログの移行の理解

この章では、ビジネス・カタログ、事前定義済カタログ、およびイントロスペクトされたコンポーネントの移行を説明します。

この章の内容は次のとおりです。

- ビジネス・カタログの移行

- BPMオブジェクトの移行

- 事前定義済カタログの移行

- イントロスペクトされたコンポーネントの移行

- プロジェクト依存関係の移行

5.1 ビジネス・カタログの移行

BPM移行ユーティリティにより、次のマッピングを使用してビジネス・カタログのコンポーネントが移行されます。

表5-1 ビジネス・カタログのマッピング

10gr3アーティファクト

12cアーティファクト

モジュール

モジュール

BPMオブジェクト

ビジネス・オブジェクト

詳細は、「BPMオブジェクトの移行」を参照してください。

ビジネス例外

ビジネス例外

詳細は、「ビジネス例外の移行」を参照してください。

イントロスペクトされたオブジェクト

「イントロスペクトされたコンポーネントの移行」を参照してください

テスト・オブジェクト

移行されません。

列挙

列挙

次の要素の移行は制限されます。

- Plumtreeコンポーネントを使用するスクリプト

- JARファイルからイントロスペクトされた列挙を使用するプロジェクト

- プロジェクトの依存性

これらの制限事項の詳細は、「制限事項」を参照してください。

5.1.1 ビジネス例外の移行

BPM移行ユーティリティでは、ビジネス・オブジェクトの移行と同様に例外を移行します。ただし、BPM 12c例外では、errorInfoという名前の属性1つのみが許可されるため、BPM移行ユーティリティではBPM 10gR3例外の名前を使用し、属性を1つのみ持つ例外を作成します。また、BPM 10gR3例外のすべての属性が含まれているビジネス・オブジェクトを作成し、元の例外の名前に接尾辞ExceptionPayloadを付加した名前を付けます。移行されたBPM 12c例外のerrorInfo属性は、このビジネス・オブジェクトを型として使用します。

5.2 BPMオブジェクトの移行

BPM移行ユーティリティでは、BPMオブジェクトが次のように移行されます。

表5-2 BPMオブジェクトの移行

BPMオブジェクト要素

12cの移行

名前

移行されます

属性

一部移行されます。詳細については、表5-3を参照してください。

メソッド

BPMスクリプトに移行されます。

詳細は、「Business Process Languageの移行の理解」を参照してください。

グループ

移行されません

プレゼンテーション

一部移行されます。

詳細は、「BPMオブジェクト・プレゼンテーションの移行」を参照してください。

継承

移行されます

ビジネス・オブジェクト間の継承の移行のみがサポートされています。詳細は、「既知の問題」を参照してください。

比較可能なプロパティ

移行されません

抽象プロパティ

移行されません

5.2.1 BPMオブジェクト属性の移行

BPM移行ユーティリティでは、BPMオブジェクト属性を次のように移行します。

表5-3 BPMオブジェクト属性の移行

10gr3属性要素

12cの移行

名前

移行されます。

ドキュメント

移行されます。

イメージ、フォント・タイプ、フォント・スタイル(太字、イタリック、下線など)およびフォント色は移行されません。

型

ほとんどの型が移行されます。詳細な説明は、表5-4を参照してください。

オーバーライドされたアクセス

移行されません。

有効な値

移行されません。

主キー

移行されません。

チェック式

移行されません。

必須の式

移行されません。

BPM移行ユーティリティでは、BPMオブジェクト属性の型が次のように移行されます。

表5-4 属性の型の移行

型

12cの移行

単純な型

Anyを除き、無効な型に移行されます。この場合は、BPM移行ユーティリティの実行後、有効な型を手動で選択する必要があります。

BPMオブジェクト・タイプ

移行されます

Java/事前定義済カタログ・タイプ

移行されません

RegExp

移行されません。属性は型が無効な型として作成されます。移行を手動で完了する必要があります。

配列

単純な型およびBPMオブジェクト型の配列は移行されます。

ビジネス・カタログの事前定義型配列はANY型の配列として移行されます。

AssociativeArray

移行されません。属性は型が無効な型として作成されます。移行を手動で完了する必要があります。

イテレータ

移行されません。属性は型が無効な型として作成されます。移行を手動で完了する必要があります。

仮想

移行されません。属性は通常の属性として作成されます。

5.2.2 BPMオブジェクト・プレゼンテーションの移行

BPM 10gR3の各オブジェクト・プレゼンテーションは、BPM 12cヒューマン・タスクに移行されます。

ヒューマン・タスクのペイロードには、BPM 10gR3 BPMオブジェクト・プレゼンテーションに表示される属性が含まれます。BPMグループのように移行がサポートされていない属性の型は、ヒューマン・タスクのペイロードに含まれません。

BPM移行ユーティリティにより、各ヒューマン・タスクについてタスク・フォーム・ウィザード・コンテキスト・ファイルが生成されます。このファイルには、レイアウトおよび参照情報が含まれます。タスク・フォーム・ウィザードを使用してフォームを作成すると、BPMオブジェクト・プレゼンテーションの設計に使用したレイアウトおよび参照情報を使用できます。

また、BPM移行ユーティリティでは、10gR3のBPMオブジェクト・プレゼンテーションのコールが移行済ヒューマン・タスクの使用に移行されます。

BPMオブジェクト・プレゼンテーションの移行の結果は次のようになります。

- ヒューマン・タスク
ヒューマン・タスクには、BusinessObjectFullName、"_"、PresentationNameおよび".xml"を連結した名前が付けられます

- FormWizardInfoファイル
このファイルには、フォームで使用された属性およびフォームのレイアウトに関する情報が含まれます。

これは、"TaskFormUiCtx_"、BusinessObjectName、"_"およびPresentationName+".xml"を連結した名前を使用してHumanTaskディレクトリに格納されます

- ペイロード・ファイル
このファイルの名前と場所は、ヒューマン・タスクAPIによって定義されます。

タスク・フォーム・ウィザードでFormWizardInfoファイルを使用するには、ヒューマン・タスク・エディタを開き、「タスク・フォームの自動生成」オプションを選択します。ヒューマン・タスクと一致する名前のFormWizardInfoファイルが存在する場合、このオプションが選択可能になります。

5.3 事前定義済カタログの移行

BPM 12cでは、事前定義済カタログはサポートされていません。可能な場合、移行ユーティリティにより、事前定義済コンポーネントのメソッド使用はBPM 12cの対応するものに移行されます。

表5-5に、事前定義済カタログのすべてのコンポーネント・グループ(Fuegoブロック)を示し、可能な場合、どのようにすればBPM 12cで同様の動作が得られるかを説明しています。

表5-5 事前定義済カタログの移行

コンポーネント

12cの移行

詳細

Plumtree

使用不可

使用不可

Java

BPMスクリプトで使用可能

スクリプト・タスクおよびビジネス・メソッドでの使用は、Groovyから使用可能な同様のJavaメソッド起動に移行されます。単純な型またはビジネス・オブジェクトを取って返すメソッドのみが移行されます。

Javaタイプを返すメソッドは移行できません。

コンポーネントjava.net.InetAddressは移行できません。移行するメソッドにこのコンポーネントからのメソッドのコールが含まれている場合、移行はコンパイル・エラーで失敗します。推奨する回避策は、このコンポーネントを使用する10gR3プロジェクトのコードの行をコメント化し、移行を完了した後、コードのコメント化を解除して、手動で移行することです。

Fuego – XML – XMLObject

一部

XML定義はXSDファイルに移行されます。

ネイティブな使用(宣言、変数割当てなど)はBPMスクリプトに移行されます。

この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego – XML – DynamicXML

使用不可

遷移および条件には、ネイティブXPATHサポートを使用します。

Fuego – ルール

使用不可

複雑なビジネス・ルールは、Oracle Business Rulesを使用してください。

単純なビジネス・ルールの場合、この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego – Social

使用不可

UMSアダプタを使用します。

この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego - テスト

使用不可

Oracle BPM Studioのデバッガを使用します。詳細は、Oracle Business Process Management Studioによるビジネス・プロセスの開発のBPMプロジェクトのデバッグを参照してください。

Fuego – RQL

使用不可

この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego – JMX

使用不可

この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego – UI

使用不可

-

Fuego – Webサービス

一部

Webサービス定義はWSDLファイルに移行されます。Oracle BPM SuiteおよびOracle SOA Suiteでは、Webサービス起動のネイティブ・サポートを提供しています。

Fuego – PAPI

手動移行

-

Fuego – FDI

使用不可

使用不可

Fuego – Util

使用不可

この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego – Lib

使用不可

この情報の一部は、BPM 12cの事前定義済変数によってサポートされています。また、カスタム拡張の作成に、BPMスクリプトおよび移行マッパー・フレームワークの使用も検討してください。

Fuego – Lang

使用不可

-

Fuego – Net

使用不可

-

Fuego – NetX

使用不可

-

Fuego – Msg

使用不可

-

Fuego – Auth

使用不可

-

Fuego – Bis

使用不可

-

Fuego – Chart

使用不可

チャートおよびレポート機能には、Oracle BAMを使用してください。

Fuego – Corba

使用不可

この機能を置換するカスタム・コンポーネントを追加するように、スクリプト・マッピング・フレームワークおよびスクリプト・カスタム・ライブラリを拡張できます。すると、fuegoブロック・コンポーネントの使用を、作成したカスタム・コンポーネントに移行できます。

Fuego – EJB

使用不可

-

Fuego – IO

使用不可

-

Fuego – SQL

使用不可

データベース・アダプタを使用します。

Fuego – COM

使用不可

レポートには、Oracle Business Intelligence Publisherを使用してMicrosoft ExcelおよびMicrosoft Wordレポートを生成します。

Fuego – Dynamic

使用不可

-

5.4 イントロスペクトされたコンポーネントの移行

BPM 12cではコンポーネントのイントロスペクションはサポートされていませんが、Oracle BPM Suiteの機能またはOracle SOA Suiteの機能を使用する外部コンポーネントとの統合をサポートしています。

表5-6に、BPM 10gR3のイントロスペクトされたコンポーネントがどのようにBPM 12cに移行されるかを示します。

表5-6 イントロスペクトされたコンポーネントの移行

テクノロジ

12cの移行

ビジネス・オブジェクト

自動移行。

COM

使用不可。

.NET

使用不可。

SQL

使用不可。

BPM 12cのスタック・レベルのデータベース・アダプタを使用できます。

SQL問合せ

使用不可。

EJB

BPM 12cでは使用不可。Oracle SOA Suiteを使用してEJBを追加できます。

列挙

自動移行。

XMLスキーマ

移行ユーティリティは、イントロスペクトされたスキーマ・メタデータを使用して、移行されたプロジェクトにXSDファイルを作成します。

詳細は、「イントロスペクトされたXMLスキーマの移行」を参照してください。

JNDI

使用不可。

JMX

使用不可。

JPD

使用不可。

Webサービス統合を使用して、この機能を再作成できます。

Java

ライブラリは手動で移行する必要があります。BPMスクリプトから、それに含まれているメソッドとクラスを起動します。詳細は、Oracle Business Process Management Studioによるビジネス・プロセスの開発のBPMスクリプトの作成に関する項を参照してください。

Oracle Service Bus

移行ユーティリティにより、WSDL定義ファイルが作成されます。

SAP

使用不可。

Corba

使用不可。

Webサービス

WSDLは、XMLスキーマの説明と同様の制限付きで移行されます。「イントロスペクトされたXMLスキーマの移行」を参照してください。

BPM 12cではBPMスクリプトからWebサービスを起動することはできないため、Webサービスを起動するBusiness Process Languageコードの移行はできません。Webサービスはサービス・タスクを使用して手動で統合できます。

5.4.1 イントロスペクトされたXMLスキーマの移行

BPM移行ユーティリティでは、XMLスキーマを次のように移行します。

- XMLスキーマは、BPMプロジェクトのSOA/Schemasディレクトリにコピーされます。

- WSDL定義は、BPMプロジェクトのSOA/WSDLsディレクトリにコピーされます。

インポート・タグ

イントロスペクトされたXMLスキーマまたはWSDL定義にインポート・タグが含まれていて、その結果、インポートされたスキーマに対応する追加のファイルが生成される可能性があります。

イントロスペクトされたメタデータには、元のファイル名が保存されていません。BPM移行ユーティリティでは、10gR3のイントロスペクトされたコンポーネントのコンテナ・モジュール名に、ファイルが複数存在する場合は相対的な番号を付加した名前が、これらのファイルに付けられます。

この場合は、移行ユーティリティによってログにメッセージが追加され、ファイルの名前を変更するよう警告されます。ファイルの名前を変更する際は、必ずこれらのファイルへの参照の名前も変更してください。

ネームスペースのサポート

BPM 10gR3ではネームスペース定義のないスキーマがサポートされていますが、BPM 12cではサポートされていません。ネームスペース定義が含まれないスキーマを移行する必要がある場合、次のいずれかを実行します。

- 元のスキーマにネームスペースを追加し、移行プロセスを実行する前に、再度イントロスペクトします。

- ファイルを手動で移行済プロジェクトにコピーします。インポート・タグが正しい場所を指すように確認してください。

また、WSDL定義に含まれている埋込みスキーマも変更してください。

保護されたネームスペース

次のネームスペースは12cバージョンで内部的に使用されています。10gr3プロジェクトがこのネームスペースを使用している場合、移行を実行する前に変更する必要があります: http://xmlns.oracle.com/bpel/workflow/

ファイル名の検証

BPM 12cでは、有効なXMLスキーマおよびWSDL定義が必要です。BPM移行ユーティリティによって移行中に無効な名前が検出された場合、警告メッセージがログに記録され、移行が続行されます。無効な名前は、10gR3イントロスペクション中に無効な構造が無視されたことが原因になっている可能性があります。

コンパイルの問題を回避するために、BPM 12cでこれらのファイルの名前を変更する必要があります。

5.5 プロジェクト依存関係の移行

BPM移行ユーティリティでは、プロジェクトの依存関係プロパティを移行しません。プロジェクトに他のプロジェクトとの依存関係が存在する場合、BPM移行ユーティリティによって、ソース・プロジェクトのビジネス・カタログ・コンポーネントが移行先の12c BPMプロジェクトのビジネス・カタログに移行されます。

移行されたカタログには、BPM 10gR3の元のプロジェクトの、ベース・プロジェクトおよび依存プロジェクトの両方のコンポーネントが含まれます。

6 Business Process Languageの移行の理解

この章では、BPM 10gR3のBusiness Process Languageスクリプトの移行について説明します。

この章の内容は次のとおりです。

- Business Process Languageコードの移行の概要

- Business Process Languageの制御フロー文の移行

- Business Process Languageの基本型の移行

6.1 Business Process Languageコードの移行の概要

BPM 12cでは、標準Groovyスクリプトをサポートしています。詳細は、『Oracle Business Process Management Studioでのビジネス・プロセスの開発』の「BPMスクリプトの記述」を参照してください。

次の要素の移行は制限されます。

- Plumtreeコンポーネントを使用するスクリプト

- JARファイルからイントロスペクトされた列挙を使用するプロジェクト

- プロジェクトの依存性

これらの制限事項の詳細は、「制限事項」を参照してください。

表6-1では、BPM 10gR3のBusiness Process Languageの様々なコンポーネントが、どのようにBPM 12cのスクリプトに移行されるかを示しています。

表6-1 Business Process Languageコードの移行

機能

12cの移行

Business Process Language

12cでのBPMスクリプトのサポートはGroovyに基づきます

ビジネス・オブジェクト

一部移行されます。RegExp型の属性、属性Valid valuesおよび属性Check expressionは移行されないため、スクリプトを実装する必要があります。

スキン(PBL、Java、VBasic)

Groovyスクリプト機能に移行されます

スクリプト言語例外処理

ベスト・エフォートで移行されます。「Business Process Languageの制御フロー文の移行」を参照してください

単純な型

移行されます。「Business Process Languageの基本型の移行」を参照してください

複合型

Javaタイプ、ビジネス・オブジェクトおよびXMLスキーマは移行されます。依存Javaライブラリは手動で移行する必要があります。スキーマ/XSDは、プロジェクトで使用されるエクステントに推測されて移行されます。

アクティビティ(自動およびメソッド)

スクリプト・タスクとして移行されます。

スクリプト・コードによる複数のゲートウェイ

スクリプト・タスクとして移行されます。

言語構造

「Business Process Languageの制御フロー文の移行」を参照してください

埋込みSQL

使用不可

Webサービスの起動

使用不可

事前定義変数

BPM 12cでは、事前定義済変数の新しいセットがサポートされています。詳細は、Oracle Business Process Management Studioによるビジネス・プロセスの開発のプロセス設計における情報処理に関する項を参照してください。

6.2 Business Process Languageの制御フロー文の移行

BPMスクリプトは、標準Groovyに基づいており、その制御フロー文を使用します。

BPM移行ユーティリティでは、表6-2に示す制御フロー文のマッピングを使用して、Business Process LanguageスクリプトをBPM 10gR3からBPM 12cのGroovyスクリプトに移行します。

表6-2 制御フロー文の移行

Business Process Language

Groovy

case/when/else

switch/case/default

name do end

name: {}

for/in/do

for(){}

for each/in

for(){}

for each in where

for(){if(){}}

if/then/elseif/else

if(){}elseif{}else{}

while

while(){}

is

instanceof

label:statement

label:statement

(mapped ref example) intervals[].hours

intervals.collect() {XmlDuration it -> it.hours}

do/on excep/on exit

try{}catch(){}finally{}

6.3 Business Process Languageの基本型の移行

BPM 10gR3のスクリプトのBusiness Process Language基本型は、標準Javaタイプに移行されます。

表6-3に、Business Process Language基本型の移行に使用されるマッピングを示します。

表6-3 Business Language基本型の移行

Business Process Language

BPMスクリプト

Bool

java.lang.Boolean

Fuego.Internal.Bool

java.lang.Boolean

Fuego.Internal.Int

java.lang.Integer

Fuego.Internal.Real(32)

Float

Fuego.Internal.Real(64)

java.lang.Double

Fuego.Internal.Real

java.lang.Double

Fuego.Internal.RegExp

java.util.regex.Pattern

Fuego.Internal.Str

java.lang.String

Fuego.Internal.Interval

com.oracle.scripting.lib.xml.datatype.XmlDuration

Fuego.Internal.Time

com.oracle.scripting.lib.xml.datatype.XmlCalendar

Interval

com.oracle.scripting.lib.xml.datatype.XmlDuration

Int

java.lang.Integer

Fuego.Internal.Logger

com.oracle.scripting.logger.ScriptLogger

Real(32)

java.lang.Float

Real(64)

java.lang.Double

Real

java.lang.Double

String

java.lang.String

Time

com.oracle.scripting.lib.xml.datatype.XmlCalendar

Type[] (索引付き配列)

java.util.List<Type>

TypeA[TypeB] (結合配列)

java.util.Map<TypeB, TypeA>

TypeA[ordered TypeB] (ソートされた結合配列)

java.util.SortedMap<TypeB, TypeA>

Any (スクリプトのみ)

java.lang.Object

6.4 Business Process Languageの移行後アクティビティ

Business Process Language要素の移行後、追加で実行するアクティビティがあります。

Business Process Language要素の移行後に行うアクションは次のとおりです。

- スクリプトにWebサービス呼出しがある場合、Web Servicesアダプタを使用します

- XSLT変換のかわりに、複合変換が必要なスクリプトを使用します

- 複合データ型はプレーンJavaオブジェクト(POJO)としてマップします

7 BPMのAPIの移行の理解

この章では、BPMのAPIを使用するカスタム・クライアントを移行する方法について説明します。

この章の内容は次のとおりです。

- APIの移行

7.1 APIの移行

表7-1では、BPM 10gR3でサポートされている様々なAPIの説明と、それらをBPM 12cバージョンに移行する方法の詳細を示しています。

PAPIからBPM12cへの移行の例は、次のリソースを参照してください。

- Oracle Technology Network (OTN): http://www.oracle.com/technetwork/index.html

- Java.netサイト

表7-1 APIの移行

API

説明

移行

FDI

組織情報リポジトリへの直接アクセスを可能にします。

このAPIは、BPM 10gR3で正式にサポートされていたわけではありません。fuego.fdiブロックを介したアクセスのみが正式にサポートされていました。ただし、一部の顧客はこの内部APIへのアクセスを許可されていました。

使用不可。

PAPI

カスタムJavaアプリケーションからの10gr3 BPMエンジンとの対話を可能にします。

このAPIを使用するコードを手動で移行します。

PAPI-WS

カスタムWebサービスからの10gr3 BPMエンジンとの対話を可能にします。

このAPIを使用するコードを手動で移行します。

WAPI

HTTPリクエストを使用してPAPI APIによって提供されているのと同様の機能を実行するためのフレームワークを提供します。

このAPIを使用するコードを手動で移行します。ほとんどのBPMサービスはWebサービス・インタフェースを提供します。

Oracle BPM 10.3 Javaインタフェース

BPM機能を拡張するために使用されるJavaクラスおよびインタフェース。

使用不可

8 制限事項と既知の問題

この章では、BPM 10gR3プロジェクトをBPM 12cプロジェクトに移行する際の制限事項と既知の問題について説明します。

この章の内容は次のとおりです。

- 制限事項

- 既知の問題

8.1 制限事項

次のものは移行されません。

- プロジェクトのプリファレンス
言語および現在の言語プリファレンスのみ移行されます。

- イベントにアタッチされた境界イベント
BPMNでは、アクティビティの境界イベントのみがサポートされています。イベントの境界イベントはサポートされていません。

- BPMアクティビティのランタイム設定

- BPMアクティビティの拡張設定

- BPMアクティビティのカスタム・イメージ

- 測定マーク

- オプションのタスク

- PUnitタスク

- プロセス・インタフェース

- 補正型推移

- ビジネス・ルール

- 事前定義変数

- 相関

- 未使用のロール

- グループ

- 参加者

- カスタムJSP

- Fuegoタグ・ライブラリ

- レイアウト

- ビュー

- シミュレーション

- ワークスペースのカスタマイズ

- FDI API

- 事前定義済カタログに含まれる一部のコンポーネント・グループ使用方法
「事前定義済カタログの移行」を参照してください。

- 一部のイントロスペクトされたコンポーネント
「イントロスペクトされたコンポーネントの移行」を参照してください

8.2 既知の問題

BPM 10gR3からBPM 12cにプロジェクトを移行する際に発生する可能性のある問題は、次のとおりです。

- プロジェクトの依存性
プロジェクトの依存関係プロパティおよびベース・プロジェクト・プロパティは移行されません。ただし、BPM 12cではカタログおよびロールの依存関係がサポートされています。依存関係を使用するには、ベース・プロジェクトと依存プロジェクトを同じディレクトリに保存する必要があります。たとえば、ベース・プロジェクトのパスが/home/user/baseprojectの場合、依存プロジェクトのパスは/home/user/dependentprojectである必要があります。

- パラメータ・ロール
パラメータ・ロールは、通常のロールとして移行されます。

- ビジネス・パラメータ
組織単位固有の値は移行されず、デフォルト値のみが移行されます。

- コネクタ
12cバージョンでは、コネクタをサポートしていません。コネクタはデフォルト・シーケンス・フローに置換されます。

- ドキュメント
イメージ、フォント・タイプ、フォント・スタイル(太字、イタリック、下線など)およびフォント色は移行されません。

- プレゼンテーション
空のヒューマン・タスクとして移行されます。移行を完了するには、これらのヒューマン・タスクを手動で実装する必要があります。

- カスタムJSP
カスタムJSPは移行されません。カスタムJSPをADFプロジェクトに移動することはできますが、ADFタスク・フローで適切に再利用するためには追加の作業が必要です。Fuegoタグ・ライブラリはBPM 12cでは使用できないことに注意してください。ヒューマン・タスクを使用してデータをマップする必要があります。

- ビジネス・オブジェクトの継承
ビジネス・オブジェクトの複合属性は移行されません。カタログ化された複合オブジェクトから拡張したビジネス・オブジェクトは移行されません。ビジネス・オブジェクトとビジネス例外の間の継承は移行されません。

- java.net.InetAddressメソッド・コール
コンポーネントjava.net.InetAddressは移行できません。移行するメソッドにこのコンポーネントからのメソッドのコールが含まれている場合、移行はコンパイル・エラーで失敗します。推奨される回避策は、BPM 10gR3プロジェクトで、このコンポーネントを使用するコード行をコメント化することです。移行の完了後に、コードのコメントを解除し、コールを手動で移行します。

- Plumtreeコンポーネントを使用するスクリプト
10gr3 BPMプロジェクトにPlumtreeコンポーネントを使用するスクリプトが含まれている場合、-libパラメータを使用して移行ユーティリティのantタスクを起動し、配布されたedk jar (fuego.edk-10.3.3.jar)の場所を指定する必要があります。

例: ant -lib route/to/fuego.edk-10.3.3.jar migrate10-12 -DprojectLocation=/home/myUser/OracleBPMWorkspace/Sample103Project -Ddestination=/home/myUser/migTests/FirstTest

- JARファイルからイントロスペクトされた列挙を使用するプロジェクト
BPM 10.3ではjarファイル(外部リソース)を追加し、その内部タイプをJavaとしてカタログ化できます。使用可能な型の1つに列挙型があります。

BPM 10gR3プロジェクトにjarファイルを使用してビジネス・カタログに追加した列挙が含まれている場合、-libパラメータと対応するパスを使用して、jarファイルか、またはjarファイルが含まれているディレクトリを移行ユーティリティに指定する必要があります。

次に例を示します。

ant -lib myenum.jar migrate10-12 -DprojectLocation=/home/myUser/OracleBPMWorkspace/Sample103Project -Ddestination=/home/myUser/migTests/FirstTest

- 移行レポートの欠落したクラス
移行レポートにカスタム・クラスが欠落していると示された場合、-libパラメータと対応するクラスを使用してカスタム・クラスへのパスを移行ユーティリティに指定する必要があります。

- プロジェクトの依存関係
別のプロジェクトに依存するプロジェクトを移行するには、両方のプロジェクトが同じディレクトリに保存されていることを確認する必要があります。そうしない場合、ベース・プロジェクトからのコンポーネントは移行されません。

- パスの問題: ファイルまたはディレクトリが欠落している。
BPM PS6からBPM 12cにプロジェクトを移行すると、ルールSDKから次のようなエラーが発生する場合があります。

oracle.xml.parser.schema.XSDException: /myjdev/mywork/myproject/../../../xsd/BusinessCaseRuleFact.xsd (No such file or directory) at oracle.xml.parser.schema.XSDBuilder.build(XSDBuilder.java:621)

これは、保存されたスキーマ・パスがプロジェクト・ディレクトリではなくルール・ディレクトリに対して相対的に表されている場合に発生します。

このエラーを解決するには、問題の.rulesファイルを編集して'/../../../xsd/BusinessCaseRuleF act.xsd'のすべての発生を'xsd/BusinessCaseRuleFact.xsd'で置き換え、.rulesファイルを保存してからBPM PS6プロジェクトをBPM Studio 12cで開いて移行します。

8.2.1 BPMアクティビティの移行における既知の問題

これらのBPM 10gR3アクティビティをBPM 12cに移行する際には、次の既知の問題が該当します。

タイマー・イベント

ランタイム設定は移行されません。

補正

実装なしの抽象アクティビティとして移行されます。それらを削除するか、手動による実装方法を決定する必要があります。

自動アクティビティ

- コンポーネントが実装済のアクティビティは、実装なしのBPMNサービス・タスクとして移行されます。移行を完了するには、サービス・タスクを手動で実装する必要があります。

- ループ条件は移行されません。

- 評価順序は移行されません。

- 条件は移行されません。

対話型アクティビティ

- スクリーンフロー・コールは、プロセス・コールが実装されたBPMNサービス・タスクとして移行されます。サービス・タスクはロール定義をサポートしません。したがって、ロール割当てはコールされたプロセス自体に含まれます。元のロールは変わります。

- PUnitタスクは移行されません。

- オプションのタスクは移行されません。

対話型アクティビティの次の実装は、空のヒューマン・タスクを持つBPMNユーザー・タスクとして移行されます。移行処理を完了するには、これらをどのように手動で実装するかを決定する必要があります。

- 実装なし

- コンポーネント

- メソッド

- 外部

- 入力

- 表示

- デシジョン

デシジョン・アクティビティ

デシジョン・アクティビティは、空のヒューマン・タスクを持つBPMNユーザー・タスクとして移行されます。移行処理を完了するには、これらをどのように手動で実装するかを決定する必要があります。

対話型コンポーネント・コール

対話型コンポーネント・コールは、空のヒューマン・タスクを持つBPMNユーザー・タスクとして移行されます。移行処理を完了するには、これらをどのように手動で実装するかを決定する必要があります。

- コンポーネント

- 入力

- 表示

- BPMオブジェクト対話型コール

サブフロー

動的プロセス起動はサポートされていません。

サブスクリーンフロー

実装なしの抽象アクティビティとして移行されます。アクティビティ・ラベルに接尾辞"was subscreenflow"が付加されます。実装方法を決定する必要があります。

プロセス作成

動的プロセス起動はサポートされていません。

ランタイム設定は移行されません。

終了待機

ランタイム設定は移行されません。

グローバル作成

自動完了およびその他のランタイム設定は移行されません。

グローバル自動

ランタイム設定は移行されません。

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。