| Oracle® Fusion Middleware Oracle Data Integrator開発者ガイド 11g リリース1 (11.1.1) B62260-01 |
|
 前 |
 次 |
この章では、パッケージおよびステップの概要について説明します。また、パッケージの作成プロセスを紹介し、パッケージ内でのステップの処理に関する追加情報も提供します。
この章では、次の項目について説明します。
パッケージはOracle Data Integratorで最大の実行単位です。パッケージは実行ダイアグラム内に編成された一連のステップで構成されます。
各ステップは、成功または失敗の実行結果となります。ステップは、実行結果(成功または失敗)に従って別のステップに分岐できます。
表10-1に、様々なステップのタイプを示します。その他の詳細情報の参照先も示しています。
表10-1 ステップのタイプ
| タイプ | 説明 | 関連項目 |
|---|---|---|
|
フロー(インタフェース) |
インタフェースを実行します。 |
|
|
プロシージャ |
プロシージャを実行します。 |
|
|
変数 |
変数の値を宣言、設定、リフレッシュまたは評価します。 |
|
|
Oracle Data Integratorツール |
ツールボックスから使用可能なこれらのツールは、Oracle Data Integrator APIのすべてのコマンドへのアクセスや、オペレーティング・システム・コールの実行を可能にします。 |
10.3.1.4項「Oracle Data Integratorツール・ステップの追加」 |
|
モデル、サブモデルおよびデータストア |
これらのオブジェクトに対してジャーナル化、静的チェックまたはリバースエンジニアリング操作を実行します。 |
10.3.1.5項「モデル、サブモデルおよびデータストアの関連ステップ」 |
たとえば、図10-1に表示されている「Load Customers and Invoice」というパッケージの例は、次のアクションを実行します。
なんらかのバックアップ操作を実行する「System Backup」プロシージャを実行します。
顧客グループ・データストアをロードする「Customer Group」インタフェースを実行します。
顧客データストアをロードする「Customer」インタフェースを実行します。
製品データストアをロードする「Product」インタフェースを実行します。
「Last Invoice ID」ステップの変数をリフレッシュし、この変数の値をパッケージで後で使用できるように設定します。
請求書ヘッダー・データストアをロードする「Invoice Header」インタフェースを実行します。
請求書データストアをロードする「Invoice Lines」インタフェースを実行します。
前述のいずれかのステップが失敗となると、このパッケージは、Oracle Data Integratorのツールを使用して電子メールを管理者に送信する「Send Alert」ステップを実行します。
パッケージはパッケージ・ダイアグラム・エディタで作成されます。詳細は、10.1.3項「パッケージ・エディタの概要」を参照してください。
パッケージの作成は、次の主な手順で構成されます。
新規パッケージを作成します。詳細は、10.2項「新規パッケージの作成」を参照してください。
パッケージでステップを使用します(追加、複製、削除など)。詳細は、10.3項「ステップの使用」を参照してください。
ステップの順序を定義します。詳細は、10.4項「ステップの順序の定義」を参照してください。
パッケージを実行します。詳細は、10.5項「パッケージの実行」を参照してください。
パッケージ・エディタには、パッケージを設計するための単一の環境が用意されています。図10-2に、パッケージ・エディタの概観を示します。
表10-2 パッケージ・エディタの各セクション
| セクション | 図の中の位置 | 説明 |
|---|---|---|
|
デザイナ・ナビゲータ |
左側 |
デザイナ・ナビゲータには、プロジェクト、モデル、ソリューション、およびその他(グローバル)のコンポーネントがツリー状に表示されます。 |
|
パッケージ・ダイアグラム |
中央 |
インタフェース、プロシージャ、データストア、モデル、サブモデル、変数などのコンポーネントにステップを作成するために、デザイナ・ナビゲータからパッケージ・ダイアグラムに、これらのコンポーネントをドラッグします。 このダイアグラムでは、ステップの順序の定義やステップの編成を実行することもできます。 |
|
「パッケージ」ツールボックス |
パッケージ・ダイアグラムの左側 |
ツールボックスには、Oracle Data Integratorの使用可能なツールのリストが表示され、このリストからパッケージにツールを追加できます。これらのツールは、タイプ別にグループ化されています。 |
|
「パッケージ」ツールバー |
パッケージ・ダイアグラムの最上部 |
パッケージ・ツールバーには、パッケージ内のステップを編成したり、ステップの順序を指定するツールがあります。 |
|
「プロパティ」パネル |
パッケージ・ダイアグラムの下 |
このパネルには、パッケージ・ダイアグラムで選択されているオブジェクトのプロパティが表示されます。 |
新規パッケージを作成するには:
デザイナ・ナビゲータの「プロジェクト」ツリーで、パッケージを作成するフォルダの「パッケージ」ノードをクリックします。
右クリックして「新規パッケージ」を選択します。
パッケージの「名前」を入力します。
「ダイアグラム」タブに移動します。
10.3項「ステップの使用」の説明に従って、ステップを追加します。
「ファイル」メニューから「保存」をクリックします。
パッケージは、編成された一連のステップです。パッケージの定義の大部分は、このパッケージのステップを使用することで構成されます。
ステップの追加は、挿入するステップの性質によって異なります。ステップの各タイプの詳細は、表10-1を参照してください。次に、様々なタイプのステップを追加する手順を示します。
フロー(インタフェース)ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータの「プロジェクト」ツリーから、パッケージに追加するインタフェースを選択します。
インタフェースをダイアグラムにドラッグ・アンド・ドロップします。フロー・ステップが表示されます。
ダイアグラムでステップのアイコンをクリックします。プロパティ・パネルが開きます。
「一般」タブで、「ステップ名」フィールドを編集します。
「ファイル」メニューから「保存」をクリックします。
プロシージャ・ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータの「プロジェクト」ツリーから、パッケージに追加するプロシージャを選択します。
プロシージャをダイアグラムにドラッグ・アンド・ドロップします。プロシージャ・ステップが表示されます。
ダイアグラムでステップのアイコンをクリックします。プロパティ・パネルが開きます。
「一般」タブで、「ステップ名」フィールドを編集します。
「オプション」タブで、必要に応じてプロシージャのオプションを設定します。
「ファイル」メニューから「保存」をクリックします。
Oracle Data Integratorには、変数の様々なステップがあります。
変数の宣言: 変数をパッケージ(またはパッケージ内で使用されるトポロジの要素)で使用する場合は、パッケージに変数の宣言ステップを挿入することをお薦めします。このステップで、パッケージの変数を明示的に宣言します。
変数のリフレッシュ: このステップは、変数定義に指定されている問合せを実行して、変数をリフレッシュします。
変数の設定: このステップには2つの機能があります。
割当てでは、変数の現在の値を設定します。
増分では、指定の分量ずつ数値を増減します。
変数の評価: このステップは、変数の値と指定された値をオペレータに従って比較します。条件を満たすと、評価ステップはtrueとなり、それ以外の場合はfalseとなります。このステップを使用して、パッケージ内を分岐できます。
Declaring a Variable
変数の宣言ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータで、パッケージに追加する変数を選択します。プロジェクト変数の場合は「プロジェクト」ツリーから、グローバル変数の場合は「その他」ツリーから選択します。
変数をダイアグラムにドラッグ・アンド・ドロップします。変数ステップが表示されます。
ダイアグラムでステップのアイコンをクリックします。プロパティ・パネルが開きます。
「一般」タブで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「変数の宣言」を選択します。
「ファイル」メニューから「保存」をクリックします。
Refreshing a Variable
変数のリフレッシュ・ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータで、パッケージに追加する変数を選択します。プロジェクト変数の場合は「プロジェクト」ツリーから、グローバル変数の場合は「その他」ツリーから選択します。
変数をダイアグラムにドラッグ・アンド・ドロップします。変数ステップが表示されます。
ダイアグラムでステップのアイコンをクリックします。プロパティ・パネルが開きます。
「一般」タブで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「変数のリフレッシュ」を選択します。
「ファイル」メニューから「保存」をクリックします。
変数の設定
変数の設定ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータで、パッケージに追加する変数を選択します。プロジェクト変数の場合は「プロジェクト」ツリーから、グローバル変数の場合は「その他」ツリーから選択します。
変数をダイアグラムにドラッグ・アンド・ドロップします。変数ステップが表示されます。
ダイアグラムでステップのアイコンをクリックします。プロパティ・パネルが開きます。
「一般」タブで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「変数の設定」を選択します。
変数値に対して実行する操作に従って、「割当て」または「増分」を選択します。
「値」フィールドに、設定する値または増分する値を入力します。この値に別の変数を指定することもできます。
「ファイル」メニューから「保存」をクリックします。
変数の評価
変数の評価ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータで、パッケージに追加する変数を選択します。プロジェクト変数の場合は「プロジェクト」ツリーから、グローバル変数の場合は「その他」ツリーから選択します。
変数をダイアグラムにドラッグ・アンド・ドロップします。変数ステップが表示されます。
ダイアグラムでステップのアイコンをクリックします。プロパティ・パネルが開きます。
「一般」タブで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「変数の評価」を選択します。
変数値の比較に使用する「オペレータ」を選択します。
「値」フィールドに、変数と比較する値を入力します。この値に別の変数を指定することもできます。
|
注意: 「値」フィールドには、値のリストを指定できます。INオペレータを使用する場合は、セミコロン(;)を使用してリストの値を区切ります。 |
「ファイル」メニューから「保存」をクリックします。
変数の評価ステップは、評価結果に基づいて分岐できます。ステップのブランチの詳細は、10.4項「ステップの順序の定義」を参照してください。
Oracle Data Integratorには、パッケージで単純な操作を実行する際に使用できるツールが用意されています。ツールは、組込みツール、またはユーザーがデータ統合ツールボックスを拡充できるオープン・ツールにできます。
Oracle Data Integratorツール・ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
パッケージの「ツールボックス」から、使用するツールを選択します。オープン・ツールは、「プラグイン」グループに表示されます。
パッケージ・ダイアグラムをクリックします。ツールに対応するステップが表示されます。
プロパティ・パネルの「一般」タブで、「ステップ名」フィールドに名前を入力します。
ツールのパラメータに値を設定します。パラメータを選択すると、パラメータの説明が表示されます。詳細は、付録A「Oracle Data Integrator Toolsリファレンス」を参照してください。
「コマンド」タブで、このツール・コールのコードを編集できます。
「ファイル」メニューから「保存」をクリックします。
Oracle Data Integratorパッケージでは、次のツールがよく使用されます。
OdiStartScen: Oracle Data Integratorシナリオを同期または非同期で開始します。OdiStartScenステップを作成するには、デザイナ・ナビゲータからダイアグラムにシナリオを直接ドラッグ・アンド・ドロップします。
OdiInvokeWebService: Webサービスを呼び出し、レスポンスをXMLファイルに保存します。
OSコマンド: オペレーティング・システム・コマンドをコールします。オペレーティング・システム・コマンドを使用すると、作成したパッケージがプラットフォーム依存となる可能性があります。
Oracle Data Integratorのツールのリストは、付録A「Oracle Data Integrator Toolsリファレンス」を参照してください。
|
注意: ステップ・プロパティ・パネルを介してツールのパラメータを設定する場合は、グラフィカルなヘルパーにより、簡単に使用できる方法で値を選択できます。たとえば、パラメータにプロジェクト識別子が必要な場合は、グラフィカル・インタフェースで識別子の表現が再設計され、選択肢としてプロジェクト名のリストが表示されます。「コマンド」タブに切り替えることで、コマンドと識別子を確認できます。 |
モデル、サブモデルおよびデータストアに対してジャーナル化、静的チェックまたはリバースエンジニアリングを実行できます。これらのステップを作成するプロセスは、次の各項で説明します。
パッケージにチェック・ステップを挿入するには:
|
注意: この静的チェックを実行するには、モデルでCKMを定義する必要があります。 |
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータの「モデル」ツリーから、チェックするモデル、サブモデルまたはデータストアを選択します。
このモデル、サブモデルまたはデータストアをダイアグラムにドラッグ・アンド・ドロップします。
「一般」タブまたはプロパティ・パネルで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「モデル・チェック」、「データストア・チェック」または「サブモデル・チェック」を選択します。
この静的チェックでチェックした表からエラーのある行を削除する場合は、「チェック済表からのエラーの削除」を選択します。
「ファイル」メニューから「保存」をクリックします。
ジャーナル化ステップを挿入するには:
|
注意: ジャーナル化操作を実行するには、モデルでJKMを定義する必要があります。 |
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータの「モデル」ツリーから、チェックするモデルまたはデータストアを選択します。
このモデルまたはデータストアをダイアグラムにドラッグ・アンド・ドロップします。
「一般」タブまたはプロパティ・パネルで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「モデルのジャーナル化」または「データストアのジャーナル化」を選択します。
ジャーナル化オプションを選択します。これらのオプションの詳細は、第7章「チェンジ・データ・キャプチャの使用」を参照してください。
「ファイル」メニューから「保存」をクリックします。
リバースエンジニアリング・ステップを挿入するには:
パッケージ・エディタを開き、「ダイアグラム」タブに移動します。
デザイナ・ナビゲータの「モデル」ツリーから、リバースエンジニアリングするモデルまたはデータストアを選択します。
このモデルをダイアグラムにドラッグ・アンド・ドロップします。
「一般」タブまたはプロパティ・パネルで、「ステップ名」フィールドに名前を入力します。「ステップ・タイプ」で「モデル・リバース」を選択します。
「ファイル」メニューから「保存」をクリックします。
|
注意: このリバースエンジニアリング・プロセスの実行には、モデル定義に設定されているリバースエンジニアリング・オプションが使用されます。 |
ステップを削除するには:
パッケージ・ツールバーのタブで、「自由選択」ツールを選択します。
削除するステップをダイアグラムで選択します。
右クリックして「ステップの削除」を選択します。
「OK」をクリックします。
ダイアグラムからステップが消去されます。
|
注意: パッケージ・ダイアグラムでの削除操作は元に戻すことができません。 |
ステップを複製するには:
パッケージ・ツールバーのタブで、「自由選択」ツールを選択します。
複製するステップをダイアグラムで選択します。
右クリックして「ステップの複製」を選択します。
ステップのコピーがダイアグラムに表示されます。
ステップを実行するには:
パッケージ・ツールバーのタブで、「自由選択」ツールを選択します。
実行するステップをダイアグラムで選択します。
右クリックして「実行」を選択します。
「実行」ウィンドウで、次の実行パラメータを選択します。
ステップを実行する「コンテキスト」を選択します。
ステップを実行する「論理エージェント」を選択します。
「OK」をクリックします。
「セッションを開始しました」ウィンドウが表示されます。
「OK」をクリックします。
ステップの実行は、オペレータ・ナビゲータで確認できます。
ステップのリンクされたオブジェクトは、ステップの作成元であるインタフェース、プロシージャ、変数などを指します。このオブジェクトは、パッケージ・ダイアグラムで編集できます。
ステップのリンクされたオブジェクトを編集するには:
パッケージ・ツールバーのタブで、「自由選択」ツールを選択します。
編集するステップをダイアグラムで選択します。
右クリックして「リンクされたオブジェクトの編集」を選択します。
リンクされたオブジェクトのエディタが開きます。
ダイアグラムを見やすくするために、ダイアグラム内のステップを調整できます。
ダイアグラム内のステップを調整するには:
パッケージのツールバー・メニューから「自由選択」ツールを選択します。
調整する複数のステップを選択します。
[Ctrl]キーを押しながら各ステップを選択します。
マウスの左ボタンを押したままダイアグラムでカーソルをドラッグします。
選択したステップを調整するには、次のいずれかの方法を使用できます。
ダイアグラムでステップをドラッグして位置を調整します。
右クリックし、コンテキスト・メニューから「垂直方向の位置合せ」または「水平方向の位置合せ」オプションを選択します。
ツールバーの「再編成」ボタンを使用して、ステップを自動的に再編成することもできます。
ステップを作成した後は、データ処理チェーンにおける各ステップの順序を再設定する必要があります。このチェーンには、次のルールがあります。
ステップは、「最初のステップ」として定義された一意のステップで開始します。
各ステップには、成功または失敗という2つの終了状態があります。
失敗または成功したステップは、別のステップに続けるか、パッケージの終点にできます。
失敗した場合の再試行回数を定義できます。
パッケージの始点(最初のステップ)は1つですが、終了ステップは複数設定できます。
失敗条件
次の表に、ステップが失敗状態になる条件を示します。これ以外の状況では、ステップは成功状態で終了します。
| ステップのタイプ | 失敗条件 |
|---|---|
| フロー |
|
| プロシージャ | プロシージャ・コマンドでエラーが発生しました。 |
| 変数のリフレッシュ | リフレッシュ問合せの実行時にエラーが発生しました。 |
| 変数の設定 | 変数の設定時にエラーが発生しました(無効な値)。 |
| 変数の評価 | ステップに定義された条件に一致しません。 |
| 変数の宣言 | このステップには失敗条件がなく常に成功します。 |
| Oracle Data Integratorツール | Oracle Data Integratorツールのリターン・コードがゼロではありません。このツールがOSコマンドの場合、ゼロ以外のコマンドのリターン・コードが失敗ケースです。 |
| データストア、モデルまたはサブモデルのジャーナル化 | ジャーナル化コマンドでエラーが発生しました。 |
| データストア、モデルまたはサブモデルのチェック | チェック・プロセスでエラーが発生しました。 |
| モデルのリバース | リバースエンジニアリング・プロセスでエラーが発生しました。 |
順序の定義
パッケージの最初のステップを定義するには:
パッケージ・ツールバーのタブで、「自由選択」ツールを選択します。
ダイアグラムで最初のステップとして設定するステップを選択します。
右クリックして「最初のステップ」を選択します。
ステップのアイコンに、最初のステップであることを示す記号が表示されます。
成功時の次のステップを定義するには:
パッケージ・ツールバーのタブで、「成功時の次のステップ」ツールを選択します。
ダイアグラムでステップを選択します。
マウスのボタンを押したまま、成功時に進行するステップのアイコンまでカーソルを移動し、マウス・ボタンを放します。
この操作を繰り返し、成功時の一連の経路に配置するすべてのステップをリンクします。この経路は、「最初のステップ」で定義したステップから開始する必要があります。
経路が正常に設定されたことを示す緑色の矢印が、ステップの間に「OK」ラベル付きで表示されます。変数の評価ステップの場合は、「true」のラベルが付きます。
失敗時の次のステップを定義するには:
パッケージ・ツールバーのタブで、「失敗時の次のステップ」ツールを選択します。
ダイアグラムでステップを選択します。
マウスのボタンを押したまま、失敗時に進行するステップのアイコンまでカーソルを移動し、マウス・ボタンを放します。
この操作を繰り返し、ワークフロー論理に従ってステップをリンクします。
経路が正常に設定されたことを示す赤色の矢印が、ステップの間に「ko」ラベル付きで表示されます。変数の評価ステップの場合は、緑色の矢印に「false」のラベルが付きます。
失敗時のパッケージの最終ステップを定義するには:
デフォルトでは、成功または失敗条件の後に別のステップにリンクされていないステップは、この成功または失敗の条件を満たすとパッケージを終了することになります。この動作は、ステップの動作を編集することで設定できます。
パッケージ・ツールバーのタブで、「自由選択」ツールを選択します。
編集するステップを選択します。
プロパティ・パネルで、「拡張」タブを選択します。
「失敗後の処理」または更新後の処理で「終了」を選択します。ダイアグラムで、ステップの後ろのリンクが消去されます。
必要に応じて、ステップの再試行回数と再試行間隔を「試行回数」および「試行間隔」に設定します。
パッケージを実行するには:
デザイナ・ナビゲータの「プロジェクト」ツリーで、実行するパッケージを選択します。
右クリックして「実行」を選択します。
「実行」ウィンドウで、次の実行パラメータを選択します。
パッケージが実行される「コンテキスト」を選択します。
ステップを実行する「論理エージェント」を選択します。
「OK」をクリックします。
「セッションを開始しました」ウィンドウが表示されます。
「OK」をクリックします。
パッケージの実行は、オペレータ・ナビゲータで確認できます。
