最近のアクセス:
SynchronizationEvents 外部オブジェクト

GeneXus で生成されたオフラインアプリケーションがデバイスにインストールされるたびに、GXPendingEvents という補助テーブルがローカルデータベース内に自動的に作成されます。GXPendingEvents テーブルは、オフラインで実行されたビジネスコンポーネントのすべての変更 (挿入、削除、更新) を、後でサーバーに複製するためにイベントとして格納します。各イベントには、そのイベントの状態 (EventStatus ドメインに基づく) を表す項目属性が設定されます。
SynchronizationEvents 外部オブジェクトには、GXPendingEvents のデータにアクセスして操作するためのメソッドがあります。
イメージ:39665.png イメージ:39666.png

プロパティ

なし

メソッド

HasEvents メソッド

サーバーへの送信を保留している変更がないか、またはデータをサーバーに送信したときにエラーが発生していないかをチェックします。詳細については、「SynchronizationEvents.HasEvents メソッド」を参照してください。
戻り値  Boolean
パラメーター EventStatus:EventStatus
   

GetEvents メソッド

格納されているイベントにアクセスして処理します。詳細については、「SynchronizationEvents.GetEvents メソッド」を参照してください。
戻り値  SynchronizationEventList
パラメーター EventStatus:EventStatus
   

MarkEventAsPending メソッド

後でもう一度送信するために、イベントを保留中としてマークします。詳細については、「SynchronizationEvents.MarkEventAsPending メソッド」を参照してください。
戻り値  なし
パラメーター EventGUID:GUID
   

RemoveEvent メソッド

GXPendingEvents テーブルのレジストリの一部を削除します。詳細については、「SynchronizationEvents.RemoveEvent メソッド」を参照してください。
戻り値  なし
パラメーター EventGUID:GUID
   

イベント

なし

ドメイン

EventStatus ドメイン

考えられるイベント状態の値を Numeric で示す列挙型ドメイン。
Pending  1  この状態のイベントはデバイスからサーバーに送信する準備が整っています。また、これらのイベントは、ビジネス コンポーネント トランザクションが実行されるたびに作成されます。
ProcessingServer   2 イベントがサーバー側で処理されている間の一時的な状態です。
ConfirmedServer  3 この状態は、イベントがサーバー側に正常に複製されたことを意味します。確認済みイベントをすべて格納する必要はないため、これらは GXPendingEvents テーブルから即座に削除されます。
RejectedServer  4 この状態のイベントは、何らかのエラーが原因でサーバー側に複製できませんでした。GetEvents メソッドと "GxSynchroEventSD" の [ EventErrors ] プロパティを使用して、デバイスからエラーコードとエラーメッセージにアクセスすることが可能です。
CanceledUser  5 ユーザーがイベントをキャンセルしたことを意味します。
RejectedFK  6 少なくとも 2 つの挿入イベントが送信され、そのうち 1 つに他のイベントを参照する外部キーが設定されている場合、そのイベントが失敗して RejectedServer 状態になると、外部キーが設定されているイベントも失敗しますが、こちらの状態は RejectedFK になります。たとえば、顧客/請求書モデルを使用していて、顧客と 1 件の請求書を挿入する場合について考えます。サーバーでの複製時にその顧客に関連付けられているイベントが何らかの理由で拒否された場合、請求書イベントは RejectedFK 状態になります。
: "ProcessingServer""ConfirmedServer""CanceledUser" はイベントの一時的状態であり、これらのいずれかの状態にあるイベントはすべて、GXPendingEvents テーブルから削除されます。つまり、状態が "Pending""RejectedServer"、または "RejectedFK" のイベントだけが GXPendingEvents テーブルに残ります。

EventAction ドメイン

考えられるイベントアクションです。
INS  挿入
UPD  変更 (または更新)
DLT 削除
   

EventData ドメイン

イベントデータ情報です。LongVarChar データタイプに基づいています。

EventError ドメイン

イベントエラー情報です。LongVarChar データタイプに基づいています。
 

構造化データタイプ

SyncrhonizationEventList

同期イベント情報のコレクションです。
  • EventId: GUID
    イベントの識別子
     
  • EventTimestamp: DateTime
    イベントのタイムスタンプ
     
  • EventBC: VarChar(128)
    イベントのビジネスコンポーネント
     
  • EventAction: EventAction
    イベントのアクション
     
  • EventData: EventData
    イベント関連のデータ
     
  • EventStatus: EventStatus
    イベントの状態
     
  • EventErrors: EventErrors
    イベント関連のエラー
     

適用範囲

対応しているプラットフォーム:  スマートデバイス (iOS、Android)

使用可能バージョン

この外部オブジェクトは、GeneXus X Evolution 3 以降で利用できます。

参考情報







サブページ
Created: 18/10/29 01:04 by Admin Last update: 21/05/21 02:39 by Admin
カテゴリ
Powered by GXwiki 3.0