GAM MSBuild タスク

ここに示すのは、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" />

タスクリスト

SetGAMOptions

このタスクは、新しいナレッジベースを開くか作成し、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 のインストールディレクトリー>

GetGAMOptions

このタスクは、新しいナレッジベースを開き、前のタスクで説明されている 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 以降で利用できます。