ヘッダーをスキップ

Oracle Application Management Pack for Oracle E-Business Suiteガイド
リリース12.1.0.2.0
部品番号E52969-01
目次へ移動
目次
前のページへ移動
次のページへ移動

カスタマイズ・マネージャ

概要

カスタマイズ・マネージャでは、単一のOracle E-Business Suiteインスタンスまたは複数のOracle E-Business Suiteインスタンスのカスタマイズをパッケージ化、リリースおよびレポートするプロセスを自動化できます。これは、サード・パーティのソース・コントロール・リポジトリと統合して、パッケージ化が必要なカスタマイズにアクセスする機能を提供します。また、これは1つ以上のOracle E-Business Suiteインスタンスにカスタム・パッチをデプロイするためにパッチ・マネージャと統合されます。

カスタマイズ・マネージャには、Oracle E-Business Suiteインスタンス全体でカスタム・アプリケーションを管理するためのダッシュボードがあります。これによって、インスタンス全体でカスタム・アプリケーションを登録および検証するだけでなく、特定のインスタンスの登録済カスタム・アプリケーションに関連付けられたカスタム・オブジェクトにドリルダウンする機能が提供されます。カスタム・アプリケーションの登録および検証によって、カスタム・アプリケーションに関連付けられたカスタム・パッケージを特定のOracle E-Business Suiteインスタンスにデプロイできることが保証されます。

主な利点

ファイル・タイプ

カスタマイズ・マネージャでは、次のような様々なファイル・タイプのカスタム・ファイルをパッケージ化できます。

ファイル・タイプの詳細は、付録を参照してください。

カスタマイズの作成方法の詳細は、Oracle E-Business Suite開発者ガイドおよびOracle Application Framework開発者ガイドを参照してください。

カスタマイズ・マネージャの設定手順

主な機能と定義

パッケージ

パッケージは、カスタマイズ・マネージャの基本的な作業ユニットです。パッケージは、カスタマイズの内容となるすべての関連オブジェクトと、特定のカスタマイズに必要なすべての関連メタデータで構成されます。カスタマイズ・パッケージには、カスタマイズを拡張するためにデプロイできる1つ以上の関連カスタム・パッチを含めることができます。

manifestファイル

manifestファイルには、パッケージに組み込まれるファイルのリストが含まれます。

ファイル・メタデータ・リポジトリ

ファイル・メタデータ・リポジトリには、カスタマイズ・パッケージの作成に使用されるカスタマイズ・ファイルのメタデータ情報が格納されます。この情報を使用して、システム内のカスタマイズを管理およびカタログ化できます。

テクノロジ・スタックの詳細

パッケージのテクノロジ・スタックの詳細は、パッケージがコンパイルされたOracle E-Business Suiteインスタンスのテクノロジ・スタック・プロパティのスナップショットです。

レポート

カスタマイズ・マネージャには、パッケージのレポートを生成するためのいくつかの方法があります。

レポートは、Microsoft WordのRTF、PDFおよびMicrosoft Excelで生成できます。

パッケージのリリース

カスタム・パッケージは、作成およびテストに成功した後で、場合によっては他のユーザーと共有する必要があります。これは、パッケージ・メタデータを更新し、パッケージ・ステータスを「リリース済」に設定することで実行できます。

パッケージの無効化

特定のカスタマイズが有効でなくなった場合、パッケージ・メタデータを更新してパッケージ・ステータスを「廃止」に設定することで、そのカスタマイズ・パッケージをリタイアできます。

診断テスト

この機能の診断テストの詳細は、「カスタマイズ・マネージャの診断テスト」を参照してください。

アプリケーションの標準検証

カスタマイズ・マネージャには、カスタム・パッケージに含まれるファイルが一定のコーディング標準を満たしているかどうかを確認する標準チェッカが付属しています。このチェッカは、標準のコンプライアンスについてすべてのコードをテストし、有効または無効を切り替えることはできません。

一部の標準は必須であり、カスタマイズ・マネージャでパッケージを作成しようとすると失敗します。その他の標準は推奨事項であり、標準チェッカは警告を出力しますがパッケージは作成されます。

たとえば、カスタマイズ・マネージャでは、カスタマイズ・パッケージ内に含まれる各ファイルで、ファイル内にOracle準拠のソース・ヘッダーが存在する必要があります。パッケージ内のファイルにこのヘッダーが存在しない場合、パッケージを作成できません。

Oracle準拠のソース・ヘッダー

カスタマイズ・パッケージ内に含まれる各ファイルでは、ファイル内にOracle準拠のソース・ヘッダーが存在することが推奨されます。

次に、Oracle準拠のヘッダーの例を示します。

$Header: sample.txt 10.1 2012/04/06 09:38 lmathur ship $  

ヘッダーには、次の要素が含まれます。

自動ヘッダー更新および挿入

このオプションは、パッケージの作成で使用されるファイル・ソース・マッピングの定義または更新時に有効にできます。自動ヘッダー更新オプションを選択すると、カスタマイズ・マネージャは、パッケージの作成プロセス中にソース・コントロール・リポジトリを問い合せてリビジョン番号を取得し、同じものを持つファイル内に存在するOracle準拠のヘッダーを更新します。

CVSまたはファイル・システムを使用する場合を除き、特定のソース・コントロール・リポジトリからリビジョン番号を検索するか問い合せるために適切なバージョン・コマンドが提供されていることを確認することが重要です。この機能は、ソース・リポジトリがファイル・システムの場合はサポートされません。同様に、CVSの場合も、ヘッダーは常にファイル内に存在する$Header文字列から検索されるため、バージョン・コマンドを指定する必要はありません。

重要: CVSで自動ヘッダー更新機能を使用する場合、各ソース・ファイル内に$Headerプレースホルダが存在する必要があります。プレースホルダ・ヘッダーは、ファイルがCVSにチェックインされる前にソース・ファイルに埋め込まれている必要があります。

また、ファイルにヘッダーを埋め込む前に、$Header内のファイル名の大/小文字を正しく変更する必要があります。

重要: Subversionを使用する場合、自動ヘッダー更新のためにSubversionクライアント・バージョン1.2以上を使用する必要があります。

自動ヘッダー更新はすべてのファイル・タイプでサポートされます。FormsやReportsなどのバイナリ・ファイルでは、ヘッダーに十分適切なオフセット(空白)を持つダミー・プレースホルダを提供する必要があります。リビジョン番号の増分に対応できるように、40%以上の追加オフセット(空白)を残すことをお薦めします。パッケージ作成のプロセス中に、システムではこれをプレースホルダとして使用し、適切なヘッダーで更新します。自動ヘッダー更新オプションを有効にする必要があり、ファイル・ソース・マッピング内で適切なバージョン・コマンドを指定する必要があります。ヘッダーは、ソース・コントロールのリリースおよびバージョンに基づいて計算されます。たとえば、リリース12で、Subversionリポジトリのファイルのバージョンが29のパッケージを作成する場合、計算されるヘッダー・バージョンは120.29です。

自動ヘッダー挿入は、Subversionをソース・コントロール・システムとして使用する場合に、選択したファイル・タイプでのみサポートされます。この場合、カスタマイズ・マネージャは、ファイル内に$Headerが存在しない場合でも、パッケージ作成のプロセス中にソース・ファイルに有効なOracle準拠のヘッダーを挿入します。ファイルに適切な$Headerが含まれない場合、自動ヘッダー挿入では次のファイル・タイプがサポートされます。

カスタムRTFファイルへのヘッダーの追加

カスタムRTFファイルにヘッダーを追加するには、ファイルの「Comments」プロパティにそれを追加します。たとえば、Microsoft Wordの場合、「File」メニューに移動して「Properties」を選択し、次の図に示すとおり「Comments」フィールドにヘッダーを入力します。

図の説明は本文にあります。

既存のカスタム・パッチのアップロード

カスタマイズ・マネージャ・リポジトリにカスタム・パッチをアップロードできます。

カスタマイズ・マネージャ・リポジトリで作成された既存のカスタム・パッチをアップロードするためのアップロード・オプションが用意されています。アップロード時に、「成功」というステータスを持つパッケージが作成されます。ステータスは、他のカスタマイズ・パッケージのように「リリース済」または「廃止」に移行できます。特定のパッケージに対して1つ以上のNLSパッチをアップロードできます。アップロード後、パッチ・マネージャを使用してパッチをデプロイできます。また、アップロード・パッケージには添付ファイルを追加できます。

注意: レポートおよび更新機能は、アップロード・パッケージでは使用できません。

自動ファイル・ドライバ・ファイル生成および更新

ファイル・ドライバ・ファイルは、adpatchが特定の製品(カスタム製品を含む)に対して有効なOracle E-Business Suiteファイルを識別するためのマスター・ファイルです。FormsやReportsなどの選択されたファイル・タイプについては、ファイル・ドライバ・ファイル内にエントリを保持する必要があります。そうしない場合、パッチ適用中に「パッチのファイルは既知のOracle Applicationsファイルではありません」というエラーがスローされます。

カスタマイズ・マネージャは、このファイル・ドライバ・ファイル要件に自動的に対応します。カスタマイズ・マネージャは、パッケージの関連ファイルに対して暗黙的にファイル・ドライバ・ファイルを生成します。パッチ・マネージャでのデプロイ中に、これらのエントリがカスタム製品マスター・ファイル・ドライバ・ファイルに自動的に追加されます。adpatchを使用して手動でパッチを適用する場合、adpatchを起動する前に、<package>/meta-infフォルダ内のupdateFileDriver.plを実行できます。

カスタマイズ・マネージャで作成したカスタム・パッチの適用中に「パッチのファイルは既知のOracle Applicationsファイルではありません」というエラーが発生した場合、カスタム製品の1つ以上のカスタム・ファイルでファイル・ドライバ・ファイルのエントリが欠落している可能性があります。

カスタム製品のファイル・ドライバ・ファイルは、次の場所にあります。

$<custom_product_top>/admin/driver/<custom_product_short_name>file.drv  

たとえば、XXCOがカスタム製品の場合、ファイル・ドライバ・ファイルは次の場所にあります。

$XXCO_TOP/admin/driver/xxcofile.drv  

すべてのカスタム・ファイルには、属しているカスタム製品に応じて各ファイル・ドライバ・ファイルにエントリが必要ですが、次のいずれかで始まる宛先パスを持つファイルは除きます。

javaで始まる宛先パスに含まれる任意のjavaファイルも同様です。

ファイル・ドライバ・ファイルの一般的な入力形式は次のとおりです。

<product>  <subdirectory>  <filename>  

簡単なエントリは次のとおりです。

xxco    admin/sql XXCONLADD.sql  
xxco    forms/<LANG> XXCOFORM.fmb

カスタマイズ・マネージャのメイン・ページ

図の説明は本文にあります。

カスタマイズ・マネージャのメイン・ページには、システムに登録されているパッケージがリストされます。パッケージごとに、次の情報が示されます。

名前とIDに基づいてパッケージを検索するか、「拡張検索」リンクをクリックしてその他の基準に基づいて検索を実行できます。

特定のパッケージに対して(そのステータスおよび所有権に応じて)次の機能を使用できます。

「作成」ボタンを使用して新しいパッケージを作成したり、「アップロード」ボタンを使用して既存のパッケージをアップロードすることもできます。

ページの一番下の「関連リンク」を使用して、次の機能にアクセスできます。

ファイル・ソース・マッピング

図の説明は本文にあります。

ファイル・ソース・マッピングは、ソース・コントロールまたはファイル・システム・リポジトリからカスタム・ファイルを検索するために必要なすべてのメタデータを取得します。ファイル・ソース・マッピングの作成は、通常、設定手順で1回実行します。必要に応じて、1つ以上のファイル・ソース・マッピングを作成できます。

メインのファイル・ソース・マッピング・ページでは、名前でファイル・ソース・マッピングを検索できます。表に各マッピングが次の情報とともにリストされます。

ファイル・ソース・マッピングを作成する手順

図の説明は本文にあります。

ファイル・ソース・マッピングを作成するには、次の手順を実行します。チェックアウト・コマンドの場合は、ページに指定されているチェックアウト・コマンドの構文に従ってください。

  1. ファイル・ソース・マッピングの名前を入力します。

  2. ファイル・ソース・マッピングのホスト名を入力します。値リストからホストを選択できます。

  3. ステージング・パスを入力します。これは、チェックアウト中に一時的な処理で使用する、読取り/書込みアクセス権を持つ特定のホスト上のフォルダである必要があります。

  4. ソース・コントロール・タイプを選択します。使用できる値は次のとおりです。

    ソース・コントロール・タイプを使用してチェックアウト・コマンドのデフォルトにします。ただし、チェックアウト・コマンドは、ソース・コントロールまたはファイル・システム構成に基づいて変更できます。ソース・コントロール・システムが「CVS」、SubVersionまたは「ファイル・システム」のいずれでもない場合、「その他」を選択してチェックアウト・コマンドを入力できます。

  5. ファイルのチェックアウトに使用する完了コマンドと必要なパラメータを入力します。チェックアウト・コマンドの構成に使用できるパラメータは、チェックアウト・コマンドの構文セクションに記載されています。チェックアウト・コマンドは、チェックアウト・コマンドのテスト・オプションを使用してテストすることを強くお薦めします。「ホスト」資格証明内で指定されているユーザーが、チェックアウト用に選択された特定のホストに対する適切な権限を持っていることを確認することも重要です。

  6. オプションで、ファイルをチェックアウトする前に実行する環境スクリプトを入力し、必要に応じて環境パラメータまたは事前処理を設定します。

  7. 参照の説明を入力します。

  8. 必要に応じてファイル・ソース・マッピングを「パブリック」としてマークします。

    ファイル・ソース・マッピングは、「パブリック」としてマークされている場合、すべてのユーザーが参照して、パッケージを作成するために使用できます。ただし、ファイル・ソース・マッピングを編集できるのは所有者とスーパー管理者のみです。

    この機能は、通常、システム管理者が1つのマッピングを作成し、それをすべての開発者がソース・コントロール・システムの詳細を知らなくても使用できるようにする場合に便利です。

    スーパー管理者は、すべてのトランザクションを参照できることに注意してください。スーパー管理者は、すべてのファイル・ソース・マッピング、Oracle E-Business Suiteマッピング、レポートおよびパッケージにアクセスできます。スーパー管理者は、これらを変更および削除することも可能です。

  9. 「コマンドのテスト」機能では、リモート・チェックアウト・ホストで提供されているチェックアウト・コマンドおよびバージョン・コマンドをテストできます。パッケージ作成中のチェックアウトで発生する障害を避けるため、チェックアウト・コマンドおよびバージョン・コマンドをテストすることを強くお薦めします。チェックアウト・コマンドのテストの情報を入力します。

    図の説明は本文にあります。

    次の情報を入力します。

    「プレビュー」または「テスト」ボタンを使用して、チェックアウト・コマンドとバージョン・コマンドをプレビューまたはテストします。結果は、コマンド・プレビューまたは「テスト結果」フィールドに表示されます。

「類似作成」オプションを使用してファイル・ソース・マッピングを作成する手順

既存のファイル・ソース・マッピングから詳細をコピーして、ファイル・ソース・マッピングを作成するには、「類似作成」ボタンを選択します。この手順は、通常、ファイル・ソース・マッピングのミラー・コピーを作成する場合や、わずかな変更を含む別のファイル・ソース・マッピングを、そのファイル・ソース・マッピングに関連するすべての詳細を入力せずに作成する場合に使用できます。

ファイル・ソース・マッピングを更新する手順

ファイル・ソース・マッピングを更新するには、メインのファイル・ソース・マッピング・ページにリストされている名前をクリックします。次に説明するフィールドのみを更新できます。特定のファイル・ソース・マッピングのホストを更新することはできません。

「有効」ボックスを選択または選択解除して、ファイル・ソース・マッピングを有効化または無効化できます。

  1. ソース・コントロール・タイプを入力します。使用できる値は次のとおりです。

  2. ファイルのチェックアウトに使用する完了コマンドと必要なパラメータを入力します。

  3. ステージング・パスを入力します。ステージング・パスは、ファイルのチェックアウト先となる、書込み権限のあるディレクトリの場所です。

  4. オプションで、ファイルをチェックアウトする前に実行する環境スクリプトを入力し、環境パラメータを設定します。

  5. 説明を入力します。

  6. 必要に応じてファイル・ソース・マッピングを「パブリック」としてマークします。「パブリック」としてマークされている場合、すべてのユーザーがマッピングを参照できます。ただし、これを編集できるのは所有者とスーパー管理者のみです。

  7. チェックアウト・コマンドをプレビューし、リモート・チェックアウト・ホストでそれをテストできるように、個別のプレビューおよびテスト・セクションが用意されています。チェックアウト・コマンドは、実際にそれを使用してパッケージを作成する前にテストすることを強くお薦めします。

    次の情報を入力します。

    「プレビュー」または「テスト」ボタンを使用して、チェックアウト・コマンドをプレビューまたはテストします。結果は、コマンド・プレビューまたは「テスト結果」フィールドに表示されます。

パラメータのあるファイル・ソース・マッピングの例

次の表に、ファイル・ソース・マッピング・パラメータに関する情報と、各パラメータのサンプル値を示します。

名前 説明 関連するユーザー・インタフェース・ページ サンプル値
%product_code% 製品コードの置換変数 パッケージの作成/更新 - ファイルのリスト xxco
%file_path% ソース・パスの置換変数 パッケージの作成/更新 - ファイルのリスト patch/115/import
%file_name% ファイル名の置換変数 パッケージの作成/更新 - ファイルのリスト Custom_Responsibilities.ldt
%version% バージョンの置換変数 パッケージの作成/更新 - ファイルのリスト 115.32
%lang_code% 言語の置換変数 パッケージの作成/更新 - ファイルのリスト US
%branch% ブランチの置換変数 パッケージの作成/更新 - 一般 Prod13
%tag% タグの置換変数 パッケージの作成/更新 - 一般 Release12c
%user_name% ユーザー名の置換変数 パッケージの作成/更新 - 一般 developer1
%password% パスワードの置換変数 パッケージの作成/更新 - 一般 welcome1

次に、パラメータのあるチェックアウト・コマンドの構文を示します。

svn cat file:///usr/local/svn/%product_code%/%file_path%/%lang_code%/%file_name% --username %user_name% --password %password% > %file_name%

次に、パラメータが値に置換された前述のチェックアウト・コマンドを示します。

svn cat file:///usr/local/svn/xxco/patch/115/import/US/Custom_Responsibilities.ldt --username developer1 --password <password> > Custom_Responsibilities.ldt

E-Business Suiteマッピング

図の説明は本文にあります。

E-Business Suiteマッピングの作成は、オプションの設定手順です。このマッピングは、JavaまたはPLDファイルのコンパイルが必要な場合に使用します。また、レポート生成でも使用します。E-Business Suiteマッピングは、JavaまたはPLDファイルのコンパイルや、レポート生成で使用するOracle E-Business Suiteインスタンスを示します。このインスタンスに対するすべての操作は読取り専用であり、E-Business Suiteマッピングのインスタンスを使用することでカスタマイズ・マネージャを通じて特定のインスタンスになんらかの変更が発生することはありません。

メインのE-Business Suiteマッピング・ページでは、名前でE-Business Suiteマッピングを検索できます。表に各マッピングが次の情報とともにリストされます。

「作成」ボタンを選択して新しいマッピングを作成します。

E-Business Suiteマッピングを作成する手順

図の説明は本文にあります。

E-Business Suiteマッピングを作成するには、次の手順を使用します。

  1. マッピングの名前を入力します。

  2. 参照Oracle E-Business Suiteインスタンスの名前を入力します。このインスタンスのオプションは、Oracle Application Management Pack for Oracle E-Business Suiteによって自動的に検出されます。

  3. 必要に応じてマッピングを「パブリック」としてマークします。

    E-Business Suiteマッピングが「パブリック」としてマークされている場合、すべてのユーザーがそれを参照し、それを使用してパッケージを作成できますが、編集できるのは所有者とスーパー管理者のみです。

    この機能は、通常、システム管理者が1つのマッピングを作成し、それをすべての開発者がソース・コントロールまたはOracle E-Business Suiteシステムの詳細を知らなくても使用できるようにする場合に便利です。

    スーパー管理者は、E-Business Suiteマッピングを含むすべてのトランザクションを参照できることに注意してください。スーパー管理者は、すべてのファイル・ソース・マッピング、E-Business Suiteマッピング、レポートおよびパッケージにアクセスできます。スーパー管理者は、これらを変更および削除することも可能です。

  4. ステージング・パスを入力します。ステージング・パスは、コンパイルおよびビルド・プロセス中の一時的な処理に使用する、書込み権限のあるディレクトリの場所です。

  5. 付加クラスパスを入力します。このフィールドは、Javaファイルでのみ有効であり、このクラスパスはパッケージの作成時にそれらのファイルに付加されます。カスタムJavaファイルがサード・パーティ・ライブラリに依存している場合、これを使用してそれらを指定できます。

  6. マッピングの説明を入力します。

「類似作成」オプションを使用してE-Business Suiteマッピングを作成する手順

既存のE-Business Suiteマッピングから詳細をコピーして、E-Business Suiteを作成するには、「類似作成」ボタンを選択します。この手順は、通常、E-Business Suiteマッピングのミラー・コピーを作成する場合や、わずかな変更を含む別のE-Business Suiteマッピングを、そのE-Business Suiteマッピングに関連するすべての詳細を入力せずに作成する場合に使用できます。

E-Business Suiteマッピングを更新する手順

E-Business Suiteマッピングを更新するには、メインのE-Business Suiteマッピング・ページの名前をクリックします。ここでE-Business Suiteマッピングの名前またはインスタンス・マッピングを更新することはできません。

  1. E-Business Suiteマッピングをアクティブにする場合、「有効」ボックスを選択します。

  2. すべてのユーザーにマッピングを参照させるかどうかに応じて、「パブリック」ボックスを選択または選択解除します。

  3. ステージング・パスを入力します。ステージング・パスは、ファイルのコンパイル先となる、書込み権限のあるディレクトリの場所です。

  4. 付加クラスパスを入力します。このフィールドは、Javaファイルでのみ有効であり、このクラスパスはパッケージのコンパイル時に環境クラスパスに付加されます。

  5. マッピングの説明を入力します。

パッケージの作成

パッケージを作成するには、次の手順を使用します。

パッケージを作成する手順

  1. パッケージの一般情報を入力します。「パッケージID」は、自動生成される一意の番号です。

    図の説明は本文にあります。

  2. ファイル・リストを入力します。

    図の説明は本文にあります。

    ファイルのリスト・ページから手動でファイル・エントリを追加または削除できます。別の方法として、「ファイルを含める」ボタンを使用して、ファイル・メタデータ・リポジトリからファイル・エントリを含めることもできます。

    ファイルごとに次の情報を入力します。

    重要: カスタマイズ・マネージャでは、カスタマイズ・パッケージ内に含まれる各ファイルで、ファイル内にOracle準拠のソース・ヘッダーが存在することが強く推奨されます。

    次に、サンプルのOracle準拠のヘッダーを示します。

    $Header: sample.txt 10.1 2012/04/06 09:38 lmathur noship $  

    ヘッダーには、次の要素が含まれます。

  3. パッケージの追加情報を入力します。

    図の説明は本文にあります。

  4. 「送信」をクリックします。

「類似作成」オプションを使用してパッケージを作成する手順

図の説明は本文にあります。

カスタマイズ・マネージャでは、既存のパッケージから詳細をコピーすることでパッケージを作成できます。この手順は、通常、パッケージのミラー・コピーを作成する場合や、わずかな変更を含む別のパッケージを、そのパッケージに関連するすべての詳細を入力せずに作成する場合に使用できます。

注意: Mozilla Firefox 5より上位のバージョンを使用する場合、「類似作成」ページは自動的にロードされません。この問題を回避するには、ページの「リフレッシュ」ボタンをクリックします。

「アップロード」オプションを使用してパッケージを作成する手順

図の説明は本文にあります。

レガシーのカスタム・パッチがある場合、新しいカスタム・パッケージのコンテキストでカスタマイズ・マネージャ・リポジトリに同じものをアップロードできます。パッケージ検索ページで「アップロード」ボタンをクリックして既存のカスタム・パッチをアップロードします。カスタム・パッチをアップロードする場合、次の情報が必要です。

このカスタマイズ・パッケージに1つ以上のカスタム・パッチ(NLSパッチ)をアップロードできます。ただし、それらのすべてが同じ一意のパッチ番号に関連付けられている必要があることが重要です。「送信」ボタンをクリックすると、「成功」というステータスでカスタマイズ・パッケージが作成されます。これで、このカスタマイズ・パッケージは、他の任意のカスタマイズ・パッケージと同じようにデプロイし、必要時に「リリース済」または「廃止」にできます。

パッケージの更新

パッケージを更新するには、メインのカスタマイズ・マネージャ・ページのパッケージ・リストを検索し、「更新」列のアイコンを選択します。

パッケージの定義を更新する手順

  1. パッケージの一般情報を入力します。「パッケージID」は、自動生成される一意の番号であり、更新することはできません。「パッケージ名」も更新することはできません。

  2. ファイルのリスト・ページから手動でファイル・エントリを追加または削除できます。別の方法として、「ファイルを含める」ボタンを使用して、ファイル・メタデータ・リポジトリからファイル・エントリを含めることもできます。

    ファイルごとに次の情報を入力します。

  3. パッケージの追加情報を入力します。

  4. 「送信」をクリックします。

パッケージの保存

パッケージ定義の作成または更新プロセス中に、Enterprise Managerで実際にパッケージを作成するリクエストを送信する前にパッケージ定義を保存する場合、「作成」または「更新」プロセスのファイルのリスト・ページまたは「送信」ページの「保存」ボタンをクリックします。パッケージ定義が保存され、メインのカスタマイズ・マネージャ・ページに「保存済」というステータスとともに表示されます。

パッケージの検索

次の基準に基づいてパッケージの拡張検索を実行できます。

パッケージの詳細の表示

パッケージの詳細を表示するには、メインのカスタマイズ・マネージャ・ページの検索結果表で名前を選択します。

パッケージの詳細

このリージョンには次の詳細が表示されます。

履歴の詳細(パッケージ履歴の表示)

パッケージ履歴によって、パッケージのライフサイクルにおけるすべての重要なイベントの時系列ビューが提供されます。

図の説明は本文にあります。

履歴の詳細ボタンを選択すると、パッケージ履歴の表示ページに移動し、そこで次のイベントに関するタイムスタンプやユーザー入力コメントなどのパッケージの高度な履歴の追跡が提供されます。

パッケージの作成および更新について、Oracle Enterpriseジョブの詳細にドリルダウンすることもできます。

ログの表示

「ログの表示」ボタンを使用して、パッケージに関する最新のOracle Enterprise Managerジョブの詳細を表示します。

ログのダウンロード

「ログのダウンロード」ボタンを使用して、パッケージ作成のための統合されたログをダウンロードします。

説明

パッケージに入力された説明はここに表示されます。

手順

パッケージ・メタデータ・フィールドに入力された指示は、ここに表示されます。

パッチ・ダウンロード

生成されたパッチごとに、次の情報がここに表示されます。

通常、各カスタマイズ・パッケージは、1つ以上の言語パッチに関連付けることができます。

Manifest

manifestファイルがここに表示されます。各ファイルの詳細には、「製品」、「ソース・パス」、「ファイル名」、「言語」、「宛先パス」、「バージョン」および「最終更新」タイムスタンプが含まれます。

manifestのダウンロード・ボタンを使用して、Microsoft Excelで表示できるカンマ区切り値(CSV)ファイルとしてmanifestをダウンロードします。

特定のファイルを検索するには、ファイルの検索フィールドにファイル名を入力して「実行」をクリックします。ここでは、ワイルドカード文字%および*がサポートされます。

テクノロジ・スタックの詳細

パッケージのテクノロジ・スタックの詳細は、パッケージがコンパイルされたOracle E-Business Suiteインスタンスのテクノロジ・スタック・プロパティのスナップショットです。パッチ・マネージャは、パッチのデプロイ時に、パッケージのデプロイ先の環境に対して、ここで指定された詳細の互換性を確認します。最初にインスタンス比較レポートを実行することで、テクノロジ・スタックの互換性を独自に確認できます。

添付ファイル

プロジェクト計画や設計ドキュメントなどの関連ドキュメントを追加または削除できます。添付ファイルごとに次の情報がリストされます。

「削除」アイコンを使用してパッケージから添付ファイルを削除できます。パッケージが「リリース済」または「廃止」の場合、添付ファイルは削除できません。

前提条件情報

ここには、前提条件パッチがコメントとともにリストされます。

メーリング・リスト

成功または失敗時にパッケージに関する通知を送信する必要のあるユーザーの電子メール・アドレスが表示されます。

パッケージ履歴

履歴の詳細ボタンをクリックしてパッケージの履歴を表示します。パッケージ履歴には、パッケージに対するすべての主要アクションの証跡が、取得されたコメントとともに表示されます。

パッケージ・メタデータの更新

図の説明は本文にあります。

パッケージ・メタデータを更新して、パッケージのステータスを変更するか、パッケージのファイル・エントリ・メタデータをファイル・メタデータ・リポジトリにプッシュできます。パッケージ・メタデータの更新ページでは、次のことを実行できます。

標準チェッカの結果

標準チェッカの結果には、標準チェッカのステータスをクリックすることでアクセスできます。

標準チェッカの結果は、結果のダウンロード・ボタンをクリックすることで、CSV形式のファイルとしてダウンロードすることもできます。

特定のファイルに関する標準チェッカの検証の詳細を表示するには、各ファイルに対する全体的なステータスをクリックします。標準チェッカの検証の詳細には、標準名、結果およびメッセージが含まれます。

標準チェッカが「エラー」で完了した場合、パッケージ処理は中断され、パッチは生成されません。

パッケージ・レポート

カスタマイズ・マネージャには、独自のカスタマイズをドキュメント化、比較および追跡するのに役立つ強力なレポート機能があります。パッケージに関する3つのタイプのレポートを生成できます。

また、「パッチ詳細」ページでテクノロジ・スタック・レポート・アイコンをクリックすると、テクノロジ・スタックの互換性情報およびレポートをパッチ・マネージャのインタビュー・プロセスで取得できます。

重要: 各カスタム・パッケージおよびデプロイ対象のインスタンスに対してインスタンス比較レポートを生成し、パッチを実際に適用する前にテクノロジ・スタックの非互換性を確認することを強くお薦めします。

レポートにアクセスするには、変更管理ダッシュボードの「レポート」リンクを使用するか、パッケージの検索ページにある「関連リンク」の下の「レポート」リンクを使用します。

レポートの作成

レポートを作成するには、次の操作を実行します。

標準レポートを作成する手順

標準レポートは、単一のパッケージに関するテクノロジ・スタック要件やmanifestファイルなどの詳細を提供します。

図の説明は本文にあります。

  1. わかりやすいレポートの名前を入力します。

  2. 「レポート・タイプ」で「標準」を選択します。

  3. 「パッケージ」フィールドに、レポートの対象とするパッケージを入力します。このパッケージのステータスは、「成功」、「リリース済」または「廃止」である必要があります。

  4. レポート形式を入力します。オプションは次のとおりです。

  5. レポート生成に使用するOracle E-Business Suiteマッピングを入力します。

  6. 「送信」をクリックします。

比較レポートを作成する手順

比較レポートでは、2つのパッケージを比較できます。たとえば、テクノロジ・スタック要件やパッケージに含まれるファイルのバージョンを比較できます。

図の説明は本文にあります。

  1. わかりやすいレポートの名前を入力します。

  2. 「レポート・タイプ」で「比較」を選択します。

  3. プライマリ・パッケージ・フィールドにパッケージ名を入力します。このパッケージのステータスは、「成功」、「リリース済」または「廃止」である必要があります。

  4. セカンダリ・パッケージ・フィールドにパッケージ名を入力します。このパッケージのステータスは、「成功」、「リリース済」または「廃止」である必要があります。

  5. レポート形式を入力します。オプションは次のとおりです。

  6. レポート生成に使用するOracle E-Business Suiteマッピングを入力します。このインスタンスは、BI Publisherを使用してレポートを発行する場合にのみ使用されることに注意してください。

  7. 「送信」をクリックします。

インスタンス比較レポートを作成する手順

インスタンス比較レポートでは、パッケージのテクノロジ・スタック・プロパティを、特定のインスタンスのテクノロジ・スタック・プロパティと比較できます。この比較を実行することで、パッケージを適切にインスタンスにデプロイできるかどうかを判断できます。

また、レポートでは、ファイル・ドライバ・ファイルの欠落エントリがリストされ、パッケージ内のファイルとバージョンがインスタンスのそれらと比較されます。

図の説明は本文にあります。

  1. わかりやすいレポートの名前を入力します。

  2. 「レポート・タイプ」でインスタンス比較を選択します。

  3. 「パッケージ」フィールドに、レポートの対象とするパッケージを入力します。このパッケージのステータスは、「成功」、「リリース済」または「廃止」である必要があります。

  4. レポート形式を入力します。オプションは次のとおりです。

  5. レポート比較に使用するOracle E-Business Suiteマッピングを入力します。このマッピングで参照されるOracle E-Business Suiteインスタンスは、パッケージに対して比較されるインスタンスになります。ベスト・プラクティスとして、パッケージをデプロイする予定のすべてのインスタンスに対してインスタンス比較レポートを生成し、実際にパッケージを適用する前に、発生する可能性のある非互換性または問題を確認することをお薦めします。

  6. 「送信」をクリックします。

レポートの表示

レポートにアクセスするには、「変更の管理」タブ→パッケージ・レポートまたはカスタマイズ・マネージャのホームページ→パッケージ・レポート(「関連リンク」の下)の順にナビゲートします。

図の説明は本文にあります。

パッケージ・レポートの検索結果表で、レポートごとに次の情報が表示されます。

標準レポートの出力ファイル

標準レポートの出力ファイルには、3つのセクションがあります。

比較レポートの出力ファイル

比較レポートの出力ファイルには、3つのセクションがあります。

インスタンス比較レポートの出力ファイル

インスタンス比較レポートの出力ファイルには、6つのセクションがあります。

レポートの検索

メインのパッケージ・レポート・ページで名前によってレポートを検索するか、「拡張検索」リンクをクリックして次のような追加基準に基づいて検索を実行できます。

E-Business Suiteマッピング: レポートの生成または比較で使用されるE-Business Suiteマッピング。

パッケージのリリースおよび共有

パッケージは、リリース後、デプロイのために他のユーザーと暗黙的に共有されます。パッケージ・メタデータの更新ページを使用して、パッケージをリリースします。「パッケージ・メタデータの更新」を参照してください。

注意: 変更承認フレームワークでは、カスタマイズ・パッケージをリリースするユーザーからのリクエストを承認者が承認すると、パッケージはリリースされます。ユーザーは、承認後に明示的にパッケージをリリースする必要はありません。

パッチ・マネージャでカスタム・パッケージをデプロイする前にインスタンス比較レポートを実行して、パッケージのテクノロジ・スタック・プロパティを、パッケージがデプロイされるインスタンスのプロパティと比較する必要があります。パッチ・マネージャは、テクノロジ・スタック・プロパティに互換性がない場合でもパッチのデプロイメントを停止しないため、インスタンス比較レポートに基づいて適切な判断を行う必要があります。

ファイル・メタデータ・リポジトリの管理

図の説明は本文にあります。

ファイル・メタデータ・リポジトリには、各ファイルのメタデータ情報が格納されます。これは、エンタープライズ内にあるすべてのカスタム・ファイルのカタログ・リポジトリとして使用できます。

ファイル・メタデータ・リポジトリは、カスタム・ファイル内のオブジェクトも認識します。この機能は、通常、オブジェクトが表、索引、順序、ビューなどのSQLスクリプトおよびPL/SQLパッケージに適用されます。

システムでは、ファイル・メタデータ・リポジトリへの追加時に、カスタム・ファイル内のオブジェクトを解析および検出できます。これは、パッケージ・メタデータの更新画面でファイル・リポジトリへのファイル・メタデータの追加ボックスを選択することで開始できます。

カスタム・オブジェクトの例は次のとおりです。

特定のファイルに移入されたオブジェクトを表示および更新できます。指定されたオブジェクトを含むファイルを検索して、パッケージの作成または更新中にそれらを含めることもできます。

検索機能は次の対象に制限されます。

ファイルの情報は、次の3つのいずれかの方法でリポジトリにアップロードできます。

メタデータの更新ページでファイル・リポジトリへのファイル・メタデータの追加オプションを使用してリポジトリにメタデータを追加できます。

ファイル・メタデータ・リポジトリには、カスタマイズ・マネージャの変更管理ダッシュボードのリンクからアクセスできます。

メインのファイル・メタデータ・リポジトリ・ページの「検索」フィールドにファイル名を入力してファイルを検索できます。別の方法として、「拡張検索」で「ファイル名」、「製品」、「言語」、「ソース・パス」、「宛先パス」または「オブジェクト名」を1つ以上使用してファイルを検索できます。

また、パッケージの作成または更新フロー中に、「ファイルを含める」ボタンを使用してファイル・メタデータ・リポジトリ内のオブジェクトを参照する1つ以上のファイルを検索できます。

manifestファイルをアップロードする手順

  1. メインのファイルmanifestリポジトリ・ページでmanifestのアップロード・ボタンを選択します。

  2. manifestファイル・フィールドの「参照」ボタンを使用してmanifestファイルを選択します。

  3. オプションで説明を追加します。

  4. 「送信」をクリックします。

個別ファイルをアップロードする手順

  1. ファイルの名前を入力します。

  2. ファイルが属する製品を入力します。

  3. ソース・パスを入力します。

  4. 宛先パスを入力します。

  5. ファイルの言語を入力します。

  6. オプションで説明を入力します。

  7. 「送信」をクリックします。

ファイル・メタデータ・リポジトリにすでに存在するファイルのメタデータを更新する方法

  1. メインのファイル・メタデータ・リポジトリ・ページにある「検索」結果表のファイルの「更新」アイコンを選択します。

  2. 必要に応じてファイル名、製品、ソース・パス、宛先パス、言語または説明を更新します。

  3. 「送信」をクリックします。

    関連オブジェクト・リージョンで1つ以上のカスタマイズ・オブジェクトを特定のファイルに関連付けることができます。たとえば、PLSファイルは、オブジェクトの1つとしてPL/SQLプロシージャ名に関連付けることができます。特定のファイル・エントリを更新して、1つ以上のカスタマイズ・オブジェクトをそれに関連付けることができます。この機能によって、カスタマイズ・オブジェクトをカタログ化し、ファイル・メタデータ・リポジトリ内の「拡張検索」オプションを使用して後から検索できます。ただし、パッケージの作成またはデプロイ中にこの情報を使用するシステム組込みの検証チェックは現在のところありません。

カスタム・アプリケーションの管理

ダッシュボードを通じてカスタム・アプリケーションを管理できます。共通のダッシュボードでは次のことができます。

ナビゲーション: 「カスタム・アプリケーション」ページには、変更管理ダッシュボード→カスタマイズ・マネージャ・リージョン→「カスタム・アプリケーション」リンクからアクセスできます。

図の説明は本文にあります。

新しいカスタム・アプリケーションを定義する手順

  1. 「カスタム・アプリケーション」ページに移動します。「追加」ドロップダウン・リストから新規カスタム・アプリケーションを選択し、「実行」をクリックします。カスタム・アプリケーションの定義ページが表示されます。

    図の説明は本文にあります。

  2. アプリケーションについて「アプリケーションの短縮名」を指定します。英数字のみを使用可能で、小文字を使用する必要があります。アプリケーションの短縮名には、xxという接頭辞を付けることをお薦めします。

  3. アプリケーションについて「アプリケーション名」を指定します。

  4. オプションで説明を入力します。

  5. 「送信」をクリックして作業を保存します。

カスタム・アプリケーションの定義は、特定のOracle E-Business Suiteインスタンスに関連付けられませんが、1つ以上のOracle E-Business Suiteインスタンスに特定のカスタム・アプリケーションを登録するために使用できます。

既存のカスタム・アプリケーションを検出する手順

  1. 「カスタム・アプリケーション」ページに移動します。「追加」ドロップダウン・リストから既存のカスタム・アプリケーションを選択し、「実行」をクリックします。カスタム・アプリケーションの検出ページが表示されます。

    図の説明は本文にあります。

  2. 検出するカスタム・アプリケーションを選択して「送信」をクリックします。「検索」機能を使用して表の結果を絞り込むことができます。

カスタム・アプリケーションを検証する手順

図の説明は本文にあります。

既存の登録済アプリケーションを検証できます。

検証の詳細は、「カスタム・アプリケーションの検証の例」を参照してください。

  1. 「カスタム・アプリケーション」ページに移動します。「関連リンク」の下のカスタム・アプリケーション・リクエスト・リンクをクリックします。カスタム・アプリケーション・リクエスト・ページが表示されます。リクエストを選択して、「検証」ボタンをクリックします。別の方法として、インスタンスを選択し、カスタム・アプリケーション・ビューの詳細画面で「検証」ボタンをクリックします。

  2. アプリケーションについて「アプリケーションの短縮名」を入力します。提供されているLOVを使用できます。アプリケーション名がデフォルトで入力されています。

  3. Oracle E-Business Suiteインスタンスを入力します。提供されているLOVを使用できます。このOracle E-Business Suiteインスタンスに対して優先資格証明を設定する必要があります。

  4. 必要に応じて、オンライン・パッチの準備レポートを生成を選択します。このレポートは、指定したカスタム・スキーマでのエディションベース再定義(EBR)違反を報告します。このレポートには、非エディション・オブジェクト(表およびマテリアライズド・ビューなどのデータ・ストレージ・オブジェクト)に関するEBRルールに準拠しておらず、エディション・オブジェクト(パッケージ、トリガー、オブジェクト・タイプなどのコード・オブジェクト)を参照しているオブジェクトが含まれます。このレポートは、リリース12.2用のオンライン・パッチの有効化パッチを適用する前に修正する必要がある命名標準違反も表示します。

  5. 「送信」をクリックします。カスタム・アプリケーションを検証するジョブを発行します。検証は、一定の標準に基づいており、Oracle Applications DBA (AD)ユーティリティによって提供されます。

カスタム・アプリケーション・リクエストで自動修正を実行する手順

カスタム・アプリケーションを検証するリクエストが失敗した場合、自動修正機能を使用して、カスタム・アプリケーションがOracle E-Business Suite標準に準拠するようにできます。

注意: この機能は検証リクエストが失敗した場合のみに使用できます。

自動修正リクエストを送信したユーザーは、結合リクエスト権限を持っている必要があります。

このリクエストは、変更承認を使用して、実行が承認される必要があります。

  1. 「カスタム・アプリケーション」ページに移動します。「関連リンク」の下のカスタム・アプリケーション・リクエスト・リンクをクリックします。カスタム・アプリケーション・リクエスト・ページが表示されます。リクエストを選択して、自動修正ボタンをクリックします。

    注意: 検証手順で失敗しなかったリクエストを選択した場合、エラー・メッセージ「自動修正には、失敗した検証リクエストのみ表示されます。」が表示されます。

  2. 図の説明は本文にあります。

    カスタム・アプリケーションの自動修正ページに、次の情報を入力します。

  3. 「送信」をクリックします。

  4. 変更承認リクエストの変更管理ダッシュボードでリクエストを確認できます。

    図の説明は本文にあります。

  5. リクエストの名前をクリックして、詳細を確認します。

    図の説明は本文にあります。

  6. リクエストに対応するジョブがパージされており、すでにEnterprise Managerシステムに存在していない場合、結合ログをダウンロードできます。

    図の説明は本文にあります。

Oracle E-Business Suiteインスタンスにカスタム・アプリケーションを登録する手順

  1. 「カスタム・アプリケーション」ページに移動します。ページの一番下のカスタム・アプリケーション・リクエスト・リンクをクリックします。カスタム・アプリケーション・リクエスト・ページが表示されます。リクエストを選択して、「登録」ボタンをクリックします。別の方法として、カスタム・アプリケーションの詳細ページの「登録」ボタンをクリックすることもできます。

  2. アプリケーションについて「アプリケーションの短縮名」を入力します。提供されているLOVを使用できます。アプリケーション名がデフォルトで入力されています。

  3. Oracle E-Business Suiteインスタンスを入力します。提供されているLOVを使用できます。このOracle E-Business Suiteインスタンスに対して必要なAPPLSYSスキーマ、APPSスキーマおよびSYSTEMスキーマの優先資格証明を設定する必要があります。

  4. アプリケーションIDを入力します。50000より大きいアプリケーションIDを使用することをお薦めします。カスタマイズ・マネージャでは、推奨されるアプリケーションIDが自動的に生成され、デフォルト設定されます。

  5. 必要に応じてAutoConfigの実行を選択します。カスタム・アプリケーションにパッチを適用できるようにするには、AutoConfigの実行が必要です。AutoConfigは、カスタム・アプリケーションの登録時に実行しない場合、手動で実行してください。

  6. 変更承認が有効な場合、通知電子メールに電子メール・アドレスを入力します。カスタム・アプリケーションを登録する場合、最初にアプリケーションを登録するリクエストを送信します。その後、このリクエストは(変更承認フレームワークに応じて自動または手動によって)承認される必要があります。

  7. コメントを入力します。

  8. 「送信」をクリックします。カスタム・アプリケーションを登録するリクエストが送信されます。

カスタム・アプリケーションの詳細を表示する手順

図の説明は本文にあります。

カスタム・アプリケーションの詳細を表示するには、「カスタム・アプリケーション」に移動してアプリケーション名を選択し、「表示」ボタンをクリックします。詳細には次の情報が含まれます。

カスタム・アプリケーション・リクエストの詳細を追跡する手順

図の説明は本文にあります。

カスタム・アプリケーション・リクエストを使用して、特定のインスタンスのカスタム・アプリケーションを登録または検証できます。

  1. 「カスタム・アプリケーション」ページに移動します。ページの一番下のカスタム・アプリケーション・リクエスト・リンクをクリックします。カスタム・アプリケーション・リクエスト・ページが表示されます。表からカスタム・アプリケーション・リクエストを選択して「表示」をクリックします。

  2. リクエストの詳細が表示されます。

    図の説明は本文にあります。

    ヒント: カスタム・アプリケーション・リクエストのログをデバッグまたは表示するには、特定のカスタム・アプリケーション・リクエストに対して「ジョブ詳細」アイコンをクリックします。これにより、カスタム・アプリケーション・リクエストに関連付けられたEMジョブ・ログに移動します。DO_JOBステップの詳細をクリックして表示し、特定のカスタム・アプリケーション・リクエストの詳細ログを参照します。カスタム・アプリケーション・リクエストが失敗した場合、ジョブ詳細ログにリストされたエラーや障害を修正した後に、新しいリクエストを送信する必要があります。

変更承認システムが有効な場合にカスタム・アプリケーションを登録または検証するジョブを実行する手順

  1. カスタム・アプリケーションを登録または検証するジョブを実行するリクエストが承認されていることを確認します。これを行うには、「カスタム・アプリケーション」ページに移動します。ページの一番下のカスタム・アプリケーション・リクエスト・リンクをクリックします。カスタム・アプリケーション・リクエスト・ページが表示されます。承認済のリクエストは、「承認」というステータスでリストされます。

  2. 表から承認済のカスタム・アプリケーション・リクエストを選択して「実行」をクリックします。

  3. カスタム・アプリケーション・リクエストの実行ページで、表示されている情報が正しいことを確認して、「送信」をクリックします。

    図の説明は本文にあります。

    システムによって、カスタム・アプリケーションを登録または検証するジョブの実行が試みられます。システムでジョブを実行できない場合、ジョブに関する詳細が表示されます。