次の表の説明では、SQL データ型を示します。Java または .NET でスクリプトを作成する場合、適切な対応するデータ型を使用します。 SQL データ型と Java データ型とSQL データ型と .NET データ型を参照してください。

SQL スクリプトでは、名前または疑問符を使用してイベントパラメータを指定できます。疑問符の使用は推奨されなくなりました。名前付きパラメータを使用することをおすすめします。1 つのスクリプト内で名前と疑問符を混在させることはできません。疑問符を使用する場合、パラメータは以下に示す順に指定する必要があり、後続のパラメータが指定されていない場合のみ省略可能です (たとえば、パラメータ 2 を使用する場合は、パラメータ 1 を使用してください)。名前付きパラメータを使用する場合は、パラメータの任意のサブセットを任意の順に指定できます。

なし。

このスクリプトは、現在の同期に対する last_download タイムスタンプを修正するために使用します。このスクリプトが定義されている場合、Mobile Link サーバは、ダウンロードスクリプトに渡す last_download タイムスタンプとして、修正した last_download タイムスタンプを使用します。通常、このスクリプトは、リモートで失われたデータをリカバリするために使用します。つまり、last_download タイムスタンプを 1900-01-01 00:00 などの過去の時間にリセットして、次の同期ですべてのデータをダウンロードできます。また、DBMS のレプリケーションなどによって、統合データベースのテーブルに対する更新のタイムスタンプが実際の更新の時刻よりも早い時刻になる場合、ダウンロード時にこれらの更新が欠落しないように、このスクリプトで最終ダウンロード時刻を調整できます。

modify_last_download_timestamp イベントの SQL スクリプトは、ストアドプロシージャとして実装してください。

このスクリプトは、同じトランザクション内にある prepare_for_download スクリプトの直前に実行されます。

• スクリプトのパラメータ
• スクリプトの追加と削除
• スクリプトでのリモート ID と Mobile Link ユーザ名
• スクリプトでの最終ダウンロード時刻
• ダウンロードタイムスタンプの生成および使用方法
• modify_next_last_download_timestamp 接続イベント
• generate_next_last_download_timestamp イベント

次の SQL 文はストアドプロシージャを作成します。次は Oracle 統合データベース用の構文です。パラメータの入出力があるストアドプロシージャを Oracle で作成する場合、次のとおりパラメータが IN OUT とマーク付けされるようにします。

CREATE OR REPLACE PROCEDURE ModifyDownloadTimestamp (
    download_timestamp  IN OUT TIMESTAMP,
    user_name   IN VARCHAR)
AS
BEGIN
     -- N is the maximum replication latency in consolidated cluster
    download_timestamp := download_timestamp - 1;
END;

次は、SQL Anywhere、Adaptive Server Enterprise、SQL Server 統合データベース用の構文です。

CREATE PROCEDURE ModifyDownloadTimestamp
        @download_timestamp DATETIME OUTPUT,
        @user_name    VARCHAR( 128 )
        AS
        BEGIN
         -- N is the maximum replication latency in consolidated cluster
        SELECT @download_timestamp = @download_timestamp - N
        END

次の Mobile Link システムプロシージャコールは、ModifyDownloadTimestamp ストアドプロシージャを modify_last_download_timestamp イベントに割り当てます。次は SQL Anywhere 統合データベース用の構文です。

CALL ml_add_connection_script(
  'my_version',
  'modify_last_download_timestamp',
  '{CALL ModifyDownloadTimestamp(
   {ml s.last_download}, 
   {ml s.username} ) }' )

次の Mobile Link システムプロシージャコールは、スクリプトバージョン ver1 を同期するときに、modifyLastDownloadTimestamp という Java メソッドを modify_last_download_timestamp 接続イベント用のスクリプトとして登録します。

CALL ml_add_java_connection_script(
  'ver1',
  'modify_last_download_timestamp',
  'ExamplePackage.ExampleClass.modifyLastDownloadTimestamp' )

次に示すのは、サンプルの Java メソッド modifyLastDownloadTimestamp です。このメソッドは、現在の新しいタイムスタンプを出力し、渡されたタイムスタンプを修正します。

public void modifyLastDownloadTimestamp(
     Timestamp lastDownloadTime,
     String userName ) {
   java.lang.System.out.println( "old date: " +
    lastDownloadTime.toString() );
   lastDownloadTime.setDate(
    lastDownloadTime.getDate() -1 );
   java.lang.System.out.println( "new date: " +
    lastDownloadTime.toString() );
   }

次の Mobile Link システムプロシージャコールは、スクリプトバージョン ver1 を同期するときに、ModifyLastDownloadTimestamp という .NET メソッドを modify_last_download_timestamp 接続イベント用のスクリプトとして登録します。

CALL ml_add_dnet_connection_script(
  'ver1',
  'modify_last_download_timestamp',
  'TestScripts.Test.ModifyLastDownloadTimestamp' )

次に示すのは、サンプルの .NET メソッド ModifyLastDownloadTimestamp です。

public void ModifyLastDownloadTimestamp(
  ref DateTime lastDownloadTime,
  string userName ) {
  System.Console.WriteLine( "old date: " +
   last_download_time.ToString() );
  last_download_time = DateTime::Now;
  System.Console.WriteLine( "new date: " +
   last_download_time.ToString() );
  }