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

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

なし。

このイベントを使って、現在同期されているパブリケーションに基づいて、同期論理を設計できます。このイベントは、end_synchronization イベントと同じトランザクションで呼び出され、end_synchronization イベントの前に呼び出されます。このイベントは、パブリケーションが同期するたびに 1 回呼び出されます。

現在の同期がアップロードを正常に適用すると、last_upload パラメーターにはこの最終アップロードが適用された時刻が含まれます。last_publication_download は、最終ダウンロード時刻としてダウンロードスクリプトに渡された値と同じです。

Ultra Light リモートデータベースが UL_SYNC_ALL を使用して同期されている場合、このイベントは 'unknown' という名前で 1 回呼び出されます。

generation_number パラメーターは、特にファイルベースのダウンロード用です。ファイルベースのダウンロードでは、ファイルがリモートで適用されるときに、世代番号の変更によって、ダウンロードの前にアップロードを強制的に行います。世代番号は、ダウンロードファイルに保存されます。

世代番号の出力値は、begin_publication スクリプトから end_publication スクリプトへ渡されます。generation_number の意味は、現在の同期がダウンロードファイルを作成するために使用されているか、現在の同期にアップロードが含まれているかによって異なります。

• スクリプトのパラメーター
• スクリプトの追加と削除
• begin_publication 接続イベント
• Mobile Link ファイルベースのダウンロード
• スクリプトでのリモート ID と Mobile Link ユーザー名
• スクリプトでの最終ダウンロード時刻

同期されるパブリケーションごとに情報を記録する必要がある場合があります。次の例では、ml_add_connection_script を呼び出して、RecordPubEndSync というストアドプロシージャーにイベントを割り当てます。

CALL ml_add_connection_script(
   'version1',
   'end_publication',
   'CALL RecordPubEndSync( 
    {ml s.generation_number}, 
    {ml s.username}, 
    {ml s.publication_name}, 
    {ml s.last_publication_upload}, 
    {ml s.last_publication_download} )' );

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

CALL ml_add_java_connection_script(
   'ver1',
   'end_publication',
   'ExamplePackage.ExampleClass.endPublication' )

次に示すのは、サンプルの Java メソッド endPublication です。このメソッドは、Mobile Link メッセージログにメッセージを出力します (メッセージを Mobile Link メッセージログに出力すると、開発時には便利ですが、運用サーバーのパフォーマンスが遅くなります)。

package ExamplePackage;
import java.sql.*;
public class ExampleClass {
  String _curUser = null;
public String endPublication(
  int generation_number,
  String user,
  String pub_name,
  Timestamp last_publication_upload,
  Timestamp last_publication_download ) {
  java.lang.System.out.println(
   "Finished synchronizing publication " + pub_name );
  return ( null );
}}

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

CALL ml_add_dnet_connection_script( 
  'ver1',
  'end_publication',
  'TestScripts.Test.EndPub'
)

次に示すのは、サンプルの .NET メソッド EndPub です。このメソッドは、Mobile Link メッセージログにメッセージを出力します (メッセージを Mobile Link メッセージログに出力すると、開発時には便利ですが、運用サーバーのパフォーマンスが遅くなります)。

public string EndPub(
  int generation_number,
  string user,
  string pub_name,
  DateTime last_publication_upload,
  DateTime last_publication_download ) {
  System.Console.Write(
   "Finished synchronizing publication " + pub_name );
  return ( null );
}