GAM リポジトリを使用できるようにするには、いくつかの手順を GeneXus IDE から実行する必要があります。
このような動作となるのは、GeneXus が、
GAM データベーステーブルを作成する必要があるか、GAM データベースの再編成を実行するだけでいいのか、何もする必要がない (GAM リポジトリが既に存在し、最新の状態のため) のかを F5 キー ( [ すべてビルド ] ) を押したときに確認するためです。
F5 キーを押すと、GAM
データストアで指定したデータベースに接続し (このデータストアの接続プロパティ (データストア名、ユーザー ID、ユーザーパスワード) を使用)、いくつかのテーブルの存在と GAM バージョンを確認します。これらのテーブルが存在しない場合は、
Repository ID を指定して、GAM データベーステーブルを作成します。
これらのテーブルが既に存在する場合は、必要な再編成が実行されます。次に、初期化が行われ、
[ Repository ID Environment ] プロパティ、
[ Administrator User Name ] プロパティ、
[ Administrator User Password ] プロパティ、
[ Connection User Name ] プロパティ、
[ Connection User Password ] プロパティが確認されます。
加えて、いくつかの注意事項を考慮して GAM の バージョンのアップグレード、GAM データストアの変更、または新規環境の作成を行います。
ここでは、このような GAM に関する操作と注意事項について説明します。
「
GeneXus から初めて GAM リポジトリを作成する」を参照してください。
GAM が有効になっているナレッジベースがあり、新しい GeneXus ビルドがインストールされ、GAM
が変わったとします。そのため、GAM オブジェクトと GAM リポジトリを更新する必要があります。
この更新は自動的に行われます。ナレッジベースで [ すべてビルド ] を実行すると、次の動作が発生します:
1.
GAM API がインポートされます。
2.GAM リポジトリで必要な再編成が実行されます。
GAM データストアのプロパティまたは環境ジェネレーターを変更したら、 [ すべてリビルド ] を実行して、すべての GAM 実行ファイル (connection.gam および application.gam) をモデルディレクトリーに移動する必要があります。
データベースは必要に応じて再編成されます。
GAM が既に有効になっているナレッジベースで新しい
環境が作成された場合、新しい環境が同じ GAM を使用する可能性があります。
GeneXus は、再編成データストアの [ Database name ] プロパティで指定したデータベースに GAM リポジトリがある場合は検出します。その場合、
[ Administrator User Name ] プロパティ、
[ Administrator User Password ] プロパティ、
[ Connection User Name ] プロパティ、
[ Connection User Password ] プロパティは初期化されないため、GeneXus ユーザーはこれらのプロパティを手動で設定する必要があります。
この場合、
[ Repository ID Environment ] プロパティは以前の環境と同じ設定になります。
そのため、この新規環境にナレッジベースの別の既存環境と同じデータベース名を指定する場合は、接続プロパティを手動で設定する必要があります。
異なる GAM データベースを指定する場合は、ケース A で説明した操作と同じです。
外部 GAM リポジトリに接続する場合、
[ Repository ID ] プロパティを設定する必要があります。この場合、 [ すべてビルド ] を実行すると、GeneXus はこのリポジトリ (接続プロパティが関連付けられたリポジトリ) が有効な GAM リポジトリの場合は検出するので、新しい GAM データベースを作成したり、このデータベースを再編成する必要はありません。これは GXserver を使用する典型的なケースで、多くのナレッジベースは同じ GAM リポジトリを使用します。
「
異なるアプリケーションで同一の GAM データベースを使用する方法」を参照してください。
「
Managing GAM Repositories and GAM Applications in GX development time」を参照してください。