Synchronization.Receive メソッド

構文

&SynchResult = Synchronization.Receive()
入力値の説明:
&SynchResult は数値の変数です。

このメソッドは、前回の同期以降にサーバーで行われたすべての変更を、デバイスで受信します。このメソッドを最初に実行したときには、サーバーからすべてのデータが取得されます。受信したデータはすべて、オフラインデータベースオブジェクトの条件を適用してサーバーで事前にフィルタリングされています。
注: このメソッドを Composite ブロック内で実行し、何らかの理由でデータの受信に失敗すると、Composite ブロックの実行が停止されます。その場合、このメソッド呼び出しの後に宣言されているすべてのアクションが実行されません。

戻されるタイプ

GeneXus で SynchronizationReceiveResult ドメインで定義されている、次のいずれかの値を返します。

Receive メッセージのコード	Receive メッセージ	Receive メッセージの理由
0	Receive OK.	Receive に成功しました。
1	Receive is not needed.	データはすべて既に同期されています。
2	Application is not offline.	アプリケーションはオンラインパネルから同期プログラムの呼び出しを試みています。
3	Has pending events.	送信する保留中のイベントが既に存在する場合は Receive を実行できません。詳細については、Synchronization.Send メソッドの説明を参照してください。
8	Already Running.	アプリケーションで受信プロセスが既に実行されています。
51	Metadata error code received.Code: 1	デバイスが、行単位の同期を実行するために、無効な、または古いバージョンの OfflineDatabase を送信しています。
52	Metadata error code received.Code: 2	サーバーに送信されたハッシュが無効であるため、クライアントのテーブルとサーバーのテーブルとの相違をサーバーで算出できません。
53	Metadata error code received.Code: 3	デバイスが、無効な、または古いバージョンの OfflineDatabase を送信しています。
99	Unknown error.	不明なエラー。

注: 51、52、および 53 のエラーはサーバー側でのみ発生します。他のエラーはデバイスで発生します。

例

ボタンを押すときに Receive メソッドを呼び出す例:

Event "MyAction"
    &SynchResult = Synchronization.Receive()
EndEvent

適用範囲

オブジェクト	Smart Devices オブジェクト
対応しているプラットフォーム:	Android、Apple iOS

検討事項

GeneXus X Evolution 3 Upgrade 2 より前のバージョンの GeneXus の場合、このメソッドで返される値は次の表のように定義されます:

Receive メッセージのコード	Receive メッセージ
0	Receive OK.
1	Receive is not needed.
2	Application is not offline.
3	Has pending events.
4	Unknown error.
5	Metadata error code received.Code: 1
6	Metadata error code received.Code: 2
7	Metadata error code received.Code: 3

使用可能バージョン

GeneXus X Evolution 3 以降