GeneXus 15 Upgrade 11 で GeneXus Access Manager データベース構造が変更されたため、新しいバージョン 4.0.4 にアップグレードするには再編成が必要です。
データベースの再編成は、GeneXus で F5 キーを押すことで自動的に実行されます。また、GAM Deploy Tool を使用して実行することもできます。
ユーザーが GeneXus 15 upgrade 11 を使用して KB を初めて開くと、GAM をバージョン 4.0.4 に更新するにはデータベースの再編成が必要であることを警告するダイアログが表示されます。このメッセージの確認後、データベースが再編成されます。
通常どおり、GAM 外部オブジェクト (GAM ライブラリ) がインポートされ、新しいバージョンに更新されます。
再編成は、常に順序に従って段階的に実行されます:
- 3.0.6 から 4.0.0 へ
- 4.0.0 から 4.0.1 へ
- 4.0.1 から 4.0.2 へ
- 4.0.2 から 4.0.3 へ
- 4.0.3 から 4.0.4 へ
4.0.4 バージョンへの再編成
再編成は基本的に次の内容を意味します:
- 新規テーブル SessionHistoryLog
- Session と SessionHistory 列の変更。
具体的には次のような SQL 文が実行されます:
ALTER TABLE gam. [ Session ] ADD [ SesJson ] NVARCHAR(MAX) NULL , [ SesExtTokenRefresh ] nvarchar(2000) NULL , [ SesExtTokenExpires ] datetime NULL , [ SesExtToken3 ] NVARCHAR(MAX) NULL
ALTER TABLE gam. [ SessionHistory ] ADD [ SesHisJson ] NVARCHAR(MAX) NULL , [ SesHisAutTypeName ] nchar(60) NULL , [ SesHisExtTokenRefresh ] nvarchar(2000) NULL , [ SesHisExtTokenExpires ] datetime NULL , [ SesHisExtToken3 ] NVARCHAR(MAX) NULL
CREATE TABLE gam. [ SessionHistoryLog ] ( [ RepId ] int NOT NULL , [ SesHisToken ] nchar(120) NOT NULL , [ SesHisLogGuid ] nchar(40) NOT NULL , [ SesHisLogDateTime ] datetime NOT NULL , [ SesHisLogType ] nchar(30) NOT NULL , [ SesHisLogDetail ] NVARCHAR(MAX) NULL , PRIMARY KEY( [ RepId ] , [ SesHisToken ] , [ SesHisLogGuid ] ))
再編成のスクリプトは、<GX のフォルダ>\Library\GAM\Net<プラットフォーム>\ReorganizationScript403To404.txt です。
GAM Deploy Tool について
GAM Deploy Tool には GAM スキーマの更新オプションがあり、これによってデータベースを最新バージョンに更新できます。
バージョン 4.0.4 のデータベースからエクスポートしたデータをバージョン 4.0.3 のデータベースにインポートする際には、データベーステーブルの再編成に関する通知が表示されます。
バージョン 4.0.4 のデータベースからエクスポートされたデータは、再編成しないとバージョン 4.0.3 (またはそれ以前) のデータベースにインポートできません。
そのためには、GAM データベース構造に対応する GAM deploy Tool のバージョンをダウンロードします。
GAM 4.0.4 と以前のバージョンの GeneXus との互換性
- GeneXus 15 upgrade 11 より前のバージョンで生成されたアプリケーションは、GAM Database 4.0.4 を使用できます。
- GeneXus 15 Upgrade 11 で生成されたアプリケーションは、常に GAM バージョン 4.0.4 を使用します。
- 4.0.4 への変換の際に、GAMExamplelogin で使用される画像を任意の認証タイプで指定できるようになったため、認証タイプ (Facebook、Twitter、Google) に既定の画像を割り当てるプロシージャーが自動的に実行されます。このプロシージャーは、4.0.4 への変換を行う前に定義したものです。
SAC #43442
|