ソース・コントロール管理の下でのリポジトリ開発のためのシステムのセットアップ

ソース・コントロール管理でリポジトリを開発するためのシステムを設定するには、SCMシステムに固有のコマンドを使用してSCM構成ファイルを設定し、MDS XMLリポジトリを生成し、SCMシステムで確認する必要があります。

この項では、次の項目について説明します。

SCM構成ファイルの作成

Oracle BI管理ツールをソース・コントロール管理システムと統合するには、使用している特定のSCMシステムに基づいてXML構成ファイルを作成する必要があります。

この構成ファイルには、ファイルの追加、削除、チェックアウトおよび名前変更のためのSCMシステム・コマンドが含まれます。リポジトリ・オブジェクトが作成または更新されるときに、管理ツールによってこれらのコマンドがSCMシステムに発行され、その結果、対応する新しいまたは変更済MDS XMLファイルが作成されます。

注意:

管理ツールによって、変更内容がSCMシステムにコミットされることはありません。リポジトリ開発者は、常にファイルをSCMシステムに直接チェックインする必要があります。このようにして、リポジトリ開発者は、管理ツール環境ではなくSCM環境で競合を表示したり、マージ・デシジョンを指定できます。

SCMシステム用の構成ファイルを作成する手順は、次のとおりです。

管理ツールを開き、「ツール」を選択し、「オプション」を選択します。
「ソース・コントロール」タブを選択します。
「新規」をクリックして、新しい構成ファイルを作成します。「新規構成ファイルの指定」ウィンドウが表示されます。
注意: この手順は、管理ツールで開いているMDS XMLリポジトリがないことを想定しています。MDS XMLリポジトリが開いているときにSCM構成ファイルを作成または編集する場合は、「ソース・コントロールの使用」が選択されており、「新規」または「編集」ボタンが有効になっていることを確認する必要があります。
ファイル名を指定して「保存」をクリックします。ファイルには、XMLファイル拡張子が付いている必要があります。
SCM構成ファイルのデフォルトの場所は、ORACLE_INSTANCE/config/OracleBIServerComponent/coreapplication_obisnですこの場所でもテンプレートを使用できますが、このステップ中にテンプレート・ファイルを選択しないでください。かわりに、次のステップでテンプレートをロードできます。

注意:
SCM構成テンプレート・ファイルはscm-conf-ade.template.xmlおよびscm-conf-svn.template.xmlと呼ばれます。示されたORACLE_INSTANCEの場所に加えて、次のOracle Technology Network (OTN)でも入手できます。

http://www.oracle.com/technetwork/middleware/bi-foundation/downloads/obieescmconfigfiles-1568980.zip
テンプレート構成ファイルをロードするには、SCM構成エディタで「ロード」をクリックします。次に、テンプレート・ファイル(たとえば、scm-conf-svn.template)を選択し、「開く」をクリックします。
構成ファイル・テンプレート自体を変更する意図がない場合は、「構成エディタで編集」が選択されていないことを確認してください。このオプションが選択されている場合、SCM構成エディタの「構成ファイル」フィールドに表示されているファイル名は、先行ステップで指定したファイル名からテンプレート・ファイル名に変更され、変更内容はデフォルトではそのテンプレート・ファイルに保存されます。
SCM構成エディタで、オプションの説明を指定し、「コマンド」サブタブで、使用しているシステム用のコマンドを入力または編集します。長いコマンドの場合、省略記号ボタンをクリックし、「コマンド・エディタ」ウィンドウでコマンドを入力します。
${file}、${filelist}、${from}および${to}トークンを使用して、コマンドを定義します。「ファイルのリスト」オプションを、${filelist}コマンドとともに使用し、動作を設定することもできます。トークンは次のように使用できます。
- ${file}は、一度に1つファイルずつ順番にコマンドを実行する必要があることを指定します。${file}は、「フォルダ追加」および「ファイルの追加」コマンドに必要です。
- ${filelist}の動作は、「ファイルのリスト」が選択されているかどうかに応じて異なります。
  - 「ファイルのリスト」を選択しないで${filelist}を使用すると、管理ツールが、指定したコマンド(削除前、削除、チェックアウトなど)に対して、プロセスの起動に対する上限の32K文字まで可能なかぎり多くのファイルをグループ化します。実行は、すべてのファイルが処理されるまで繰り返されます。
  - 「ファイルのリスト」を選択して${filelist}を使用すると、管理ツールによって、ファイル・リストを保持する一時ファイルが作成されます。ファイル・リストのフォーマットでは行ごとに1つのファイル名を示します。これは、SCMベンダーで代表的なフォーマットとして使用されています。「ファイルのリスト」は、「削除前」、「削除」、または「チェックアウト」の各コマンドに有効です。この機能によって操作が非常に速くなるため、これをサポートしているSCMシステムでは常に選択するようにしてください。
  削除前、削除およびチェックアウトに対しては、${file}または${filelist}のいずれでも使用できます。「ファイルのリスト」は、${filelist}コマンドとともに使用する場合にのみ機能します。
- ${from}と${to}は、「名前の変更」コマンドで元のファイル名および新しいファイル名を指定するために使用されます。
  
  すべてのSCMシステムが、最初からファイルの名前変更操作をサポートしているわけではありません。このような場合、様々なコマンドを連結することで名前変更操作を構築しようと試みるのではなく、「名前の変更」フィールドを空白のままにします。管理ツールで、効率的にこれを実行できます。
注意:
いくつかのSCMシステムには、フォルダを操作するコマンドが含まれていません。このような場合は、「フォルダ追加」を空白のままにします。いつでも必要なときに、管理ツールでフォルダを作成できます。

SCMシステムにフォルダ管理コマンドが組み込まれている場合でも、管理ツールでフォルダは削除されません。必要であれば、SCMシステムで直接フォルダを削除する必要があります。

「環境変数」サブタブを選択し、SCMシステムに必要な環境変数を指定します。

環境変数は、オペレーティング・システム変数リストから直接貼り付けるか、クリップボードから貼り付けるか、手動で追加できます。この表は、「環境変数」サブタブで環境変数を管理するために使用できるオプションを示しています。

オプション	説明
環境変数の貼付け	オペレーティング・システムから環境変数を直接貼り付けられるようにします。このオプションをクリックして、ウィンドウを開き、そこでフィルタ基準を入力できます。その後、「OK」をクリックします。すべての環境変数を貼り付けるには、フィルタ・ウィンドウに*を入力します。
クリップボードから貼付け	クリップボードからテキストを直接貼り付けられるようにします。このオプションを使用するには、次の形式でテキストをコピーします。 variable_name1=variable_value1 variable_name2=variable_value2 各環境変数は、それぞれの行に配置する必要があります。注意: 標準のWindowsコマンド`set`は、環境変数に対してこのフォーマットで出力します。
追加	表に行を追加し、手動で環境変数を入力できるようにします。「変数」列に変数名を入力し、「値」列にその定義を入力します。先頭および末尾の空白は切り捨てられます。変数定義で%VAR%を使用すると、前に定義した変数を参照できます。
削除	環境変数表の指定した行を削除します。

注意:

セキュリティ・センシティブな環境変数を構成ファイルに格納しないでください。セキュリティ・センシティブな変数がSCMシステムで必要な場合は、セキュリティ・リスクを回避するために、セキュリティ・センシティブな変数がすでに設定されている管理ツールをDOSウィンドウから起動できます。

「環境変数」サブタブで「テスト」をクリックし、「SCM構成のテスト」ウィンドウを開きます。その後、コマンドを入力して、「実行」をクリックし、特定のコマンドをテストします。環境が適切である場合は、コマンドを実行した後に適切な出力が表示されます。
「保存後コメント」サブタブを選択し、管理ツールに変更を保存した後に表示されるテキストを入力します。この機能は、保存後にSCMシステムにファイルを直接チェックインすることを開発者に想起させる手段です。たとえば、保存後コメントでは次の内容を示します。
ファイルはソース・コントロールと同期されています。テスト後には必ずチェックインしてください。
「OK」をクリックして構成ファイルを保存するか、テンプレート構成ファイルをロードして変更した場合は「名前を付けて保存」をクリックしてコピーを保存します。

MDS XMLリポジトリの作成とSCMシステムへのファイルのチェックイン

SCMシステムと統合するには、Oracle BIリポジトリをMDS XML形式に変換する必要があります。

次のオプションのいずれかを使用して、MDS XMLリポジトリを作成し、それをソース・コントロール・システムにチェックインします。

既存のリポジトリ・ファイルをMDS XML形式で保存

既存のリポジトリ・ファイルがある場合、次の手順を使用してそれをMDS XMLに変換します。

この項で説明する手順は、初期インポートの推奨方法です。

既存のリポジトリ・ファイルをMDS XML形式で保存する手順は次のとおりです。

管理ツールで、既存のリポジトリ・ファイル(RPD)をオフライン・モードで開きます。
「ファイル」を選択し、「名前を付けて保存」を選択し、「MDS XMLドキュメント」を選択します。
MDS XMLリポジトリ・ファイルのルートの場所を選択し、「OK」をクリックします。
ソース・コントロール管理システムで必要な手順を実行し、ファイルを追加してチェックインします。
大部分のSCMシステムに使用可能な一括ファイル・インポート専用のコマンドを使用します。これらのコマンドは、効率的な方法でソース・コントロールにファイルのツリー全体を配信するように最適化されています。たとえば、Subversionでは次のコマンドを使用します。

svn import module_name -m "Initial import"

注意:

biserverxmlgenユーティリティを-Mおよび-Dオプションを指定して使用し、既存のRPDからMDS XMLを生成することもできます。詳細は、『Oracle Business Intelligence Enterprise Edition XMLスキーマ・リファレンス』のコマンドライン・ユーティリティを使用した既存のRPDからのMDS XMLの生成に関する項を参照してください。

新しいリポジトリをMDS XML形式で作成

MDS XML形式での新しいリポジトリの作成について説明します。

新しいリポジトリをMDS XML形式で作成する手順は次のとおりです。

管理ツールを開き、「ファイル」を選択し、「新規リポジトリ」を選択して、新規リポジトリの作成ウィザードを開きます。
ウィザードで、「MDS XMLドキュメント」オプションを選択します。他のウィザード・ステップを完了します。
ソース・コントロール管理システムで必要な手順を実行し、ファイルを追加してチェックインします。大規模なリポジトリの場合、SCMシステム用の一括ファイル・インポート専用のコマンドを使用します。

注意:

新しいMDS XML形式リポジトリを作成して、オブジェクトを追加し、ソース・コントロールへのリンクを選択することはしないでください。この方法は機能せず、SCMコマンドは生成されません。

ソース・コントロール・ファイルにリンクしてリポジトリを変換(小さいリポジトリのみ)

とても小さいリポジトリの場合は、「ソース・コントロール・ファイルへのリンク」メソッドを使用して、バイナリRPDファイルをMDS XML形式に変換できます。

ソース・コントロール・ファイルにリンクしてリポジトリを変換する手順は次のとおりです。

SCM構成ファイルを定義済であることを確認します。詳細は、SCM構成ファイルの作成を参照してください。
MDS XMLリポジトリ用の空のルート・フォルダを作成します。
管理ツールで、既存のRPDファイルをオフライン・モードで開きます。
「ファイル」を選択し、「ソース・コントロール」を選択し、「ソース・コントロール・ファイルへのリンク」を選択します。
作成したルート・フォルダおよび適切なSCM構成ファイルを選択します。
注意:
後で構成ファイルを変更する必要がある場合は、「ツール」→「オプション」→「ソース・コントロール」に移動し、「編集」をクリックして、構成ファイルを変更します。
「保存」をクリックします。MDS XMLリポジトリが作成され、必要なファイルの追加操作がソース・コントロール・システムで実行されます。
SCMシステムで変更をコミットします。

注意:

「ソース・コントロール・ファイルへのリンク」メソッドを使用したリポジトリの初期インポートは、リポジトリが非常に小さい場合にのみお薦めします。このメソッドは、大規模なリポジトリ(数万個のファイル)ではとても遅くなります。それは、管理ツールが、一括ファイル・インポート専用コマンドを使用せずに標準のファイルの追加コマンドを使用して一度に1つずつファイルをインポートするためです。

ファイルの追加コマンドを繰り返し起動すると、一時エラーが発生する可能性が高まることがあります。これが発生した場合、すべてのファイルがソース・コントロールに正常にインポートされる前に、数回このプロセスを再起動しなければならないことがあります。