ここに示すのは、GeneXus Access Manager (GAM) に関連する GeneXus MSBuild タスクのリストです。
MSBuild タスクを使用する際には、次の行を追加して、GeneXus.Tasks.targets および Genexus.GAM.Tasks.targets ファイルをベースのスクリプトファイルにインポートする必要があります。
<Import Project="$(GX_PROGRAM_DIR)\Genexus.Tasks.targets" />
<Import Project="$(GX_PROGRAM_DIR)\Genexus.GAM.Tasks.targets" />
このタスクは、新しいナレッジベースを開くか作成し、GAM オプションを設定するときに使用できます。
<SetGAMOptions
IncludeFrontendObjects="true|false"
IncludeSDSamples="true|false"
UpdateMode="never|always|prompt"
/>
IncludeFrontendObjects: Web アプリケーション用にログイン、パスワード変更、ユーザー登録フォームなどのパネルをインポートするには、値を True に設定します。そうでない場合は False に設定します。
IncludeSDSamples: ネイティブ モバイル アプリケーション用にログイン、パスワード変更、ユーザー登録フォームなどのモバイルパネルをインポートするには、値を True に設定します。そうでない場合は False に設定します。
UpdateMode: このプロパティでは、GeneXus のバージョンを変更したときに、インポートした GAM オブジェクトがどのように更新されるかを指定します。有効な値は次のとおりです。
never: GeneXus のバージョンを変更するときに、GAM オブジェクトはインポートされません。
always: GeneXus のバージョンを変更するときには常に、GAM オブジェクトがインポートされます。
prompt: GeneXus のバージョンを変更するときに、GAM オブジェクトを更新するかどうかを GeneXus IDE が確認します。
C:\temp の下にある test.build ファイルに次のターゲットがあるとします。
<Project DefaultTargets="Open" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<Import Project="$(GX_PROGRAM_DIR)\Genexus.Tasks.targets" />
<Import Project="$(GX_PROGRAM_DIR)\Genexus.GAM.Tasks.targets" />
<PropertyGroup> <!--Input Parameters-->
<WorkingDirectory></WorkingDirectory>
</PropertyGroup>
<Target Name="Open">
<OpenKnowledgeBase Directory="$(WorkingDirectory)" />
</Target>
<Target Name="CheckSetGetGAMOptions" DependsOnTargets="SetGAMProperties;CheckGAMOptions"/>
<Target Name="SetGAMProperties" DependsOnTargets="Open" >
<SetGAMOptions
IncludeFrontendObjects="$(IncludeFrontEnd)"
IncludeSDSamples="$(IncludeSDSamples)"
UpdateMode="$(UpdateMode)"
/>
</Target>
</Project>
このスクリプトでナレッジベースが開かれ、GAM オプションが設定されます。次のコマンドラインで実行できます。
msbuild "c:\temp\test.msbuild" /t:CheckSetGetGAMOptions /p:WorkingDirectory="<ナレッジベースのディレクトリー>" /p:IncludeFrontEnd=true /p:IncludeSDSamples=true /p:UpdateMode=never /p:GX_PROGRAM_DIR=<GeneXus のインストールディレクトリー>
このタスクは、新しいナレッジベースを開き、前のタスクで説明されている GAM オプションの値を取得するときに使用できます。
<GetGAMOptions>
<Output TaskParameter="IncludeFrontendObjects" PropertyName="GAMIncludeFrontend"/>
<Output TaskParameter="IncludeSDSamples" PropertyName="GAMIncludeSD"/>
<Output TaskParameter="UpdateMode" PropertyName="GAMUpdateMode"/>
</GetGAMOptions>
<Target Name="CheckGAMOptions" DependsOnTargets="Open" >
<GetGAMOptions>
<Output TaskParameter="IncludeFrontendObjects" PropertyName="GAMIncludeFrontend"/>
<Output TaskParameter="IncludeSDSamples" PropertyName="GAMIncludeSD"/>
<Output TaskParameter="UpdateMode" PropertyName="GAMUpdateMode"/>
</GetGAMOptions>
<Message Text="GAM option IncludeFrontendObjects: '$(GAMIncludeFrontend)'" />
<Message Text="GAM option IncludeSDSamples: '$(GAMIncludeSD)'" />
<Message Text="GAM option UpdateMode: '$(GAMUpdateMode)'" />
<Error Condition="$(GAMIncludeFrontend) != $(IncludeFrontEnd)" Text="GAM option IncludeFrontendObjects should be $(IncludeFrontEnd), found '$(GAMIncludeFrontend)'" />
<Error Condition="$(GAMIncludeSD) != $(IncludeSDSamples)" Text="GAM option IncludeSDSamples should be $(IncludeSDSamples), found '$(GAMIncludeSD)'" />
<Error Condition="'$(GAMUpdateMode)' != $(UpdateMode)" Text="GAM option UpdateMode should be $(UpdateMode), found '$(GAMUpdateMode)'" />
</Target>
使用可能バージョン
この機能は GeneXus 16 Upgrade 11 以降で利用できます。
|