プロパティ

[ Environment ] プロパティ

RuntimeEnvironment ドメイン

[ ExitCode ] プロパティ

参考情報

• error_handler コマンド
• GeneXus での例外処理

例

1. [ Environment ] プロパティ - 同期中の時間差
   オフライン スマート デバイス アプリケーションで、新しいレコードがデータベースに挿入されるとき、そのレコードにはデバイスのタイムスタンプ (実際のもの) が使用されますが、同期後にサーバーでは別のタイムスタンプが維持されます。この問題は、レコードを物理的に挿入するタイミングを開発者が制御することで回避できます。
   
   次のトランザクションがあるとします:

   Task
   {
      TaskId*      : Numeric(4.0)
      TaskAbstract : Character(200) 
      TaskCreated  : DateTime
   }
   Rules
      noaccept(TaskCreated);
      TaskCreated = now() if insert;

   アプリケーションがオフラインの場合、TaskCreated タイムスタンプの値はどちらになりますか。レコードがオフラインのデータベースに挿入された時点ですか、それともサーバーのデータベースに挿入された時点ですか。この問題を回避するために、次に示すように、TaskSynced 項目属性 (これも DateTime ベース) を指定し、両方のケースを区別できます:

   Task
   {
      TaskId*      : Numeric(4.0)
      TaskAbstract : Character(200) 
      TaskCreated  : DateTime
      TaskSynced   : DateTime
   }
   Rules
      noaccept(TaskCreated);
      noaccept(TaskSynced);
      TaskCreated = now() if insert and Runtime.Environment = RuntimeEnvironment.Device;
      TaskSynced  = now() if insert and Runtime.Environment <> RuntimeEnvironment.Device;

2. [ Environment ] プロパティ - オフライン通知
   スマート デバイス アプリケーションがオフラインアーキテクチャで動作するとき、通知を送信するプロセスを制御して、デバイスではなくサーバーから通知が送信されるようにする必要があります。この問題は、サーバーからの場合にのみ実行を限定する (RuntimeEnvironment.Server) ことで回避できます (ユースケース (1) に似ています)。
3. [ ExitCode ] プロパティ - Errorlevel 設定
   次のプロシージャーで終了コードが返されます (コンソールへの書き込みも行われます)。
   データを正常に保存できた場合: プロシージャーで終了コード 0 が設定され、コンソールに "Data has been saved successfully" と書き込まれます。
   データを保存できなかった場合: プロシージャーで終了コード 2 が設定され、コンソールに "Data could not be saved" と書き込まれます。
   処理されなかったという例外が発生した場合 ('Client BC' がゼロ除算の場合): プロシージャーで終了コード 1 が設定され、コンソールに例外の詳細が書き込まれます。

   &Client.Id = 1
   &Client.Name = "John"
   &Client.Save()
   If &Client.Fail()
       rollback
       msg("Data could not be saved",status)
       GeneXus.Common.Runtime.Exitcode = 2
   else
       commit
       msg("Data has been saved successfully",status)
   endif

適用範囲

使用可能バージョン