在下表中，说明部分提供 SQL 数据类型。如果您使用 Java 或 .NET 编写脚本，则应该使用相应的数据类型。 请参见SQL-Java 数据类型和SQL-.NET 数据类型。

在 SQL 脚本中，可以按名称或使用问号指定事件参数。不建议使用问号，建议您使用命名参数。不能在一个脚本中混合使用名称和问号。如果使用问号，则参数必须按照如下所示的顺序并且仅当没有指定任何后继参数时才是可选的（例如，如果您想使用参数 2，则必须使用参数 1）。如果使用命名参数，则可以按照任何顺序指定任意参数子集。

缺省世代号是 1。如果未为此事件定义脚本，则发送到远程数据库的世代号始终为 1。

此事件使您可以根据当前正在同步的发布来设计同步逻辑。此事件与 begin_synchronization 事件在相同的事务中并在 begin_synchronization 事件之后被调用。对于当前正在同步的每个发布，将调用此事件一次。

此事件的一个潜在用途是根据所用的发布控制下载内容。例如，假设有一个表，它同时属于优先级发布 (PriorityPub) 和所有表的发布 (AllTablesPub)。begin_publication 事件的脚本可将这些发布名存储在 Java 类或 SQL 变量或包中。然后，根据正在同步的发布是 PriorityPub 还是 AllTablesPub，下载脚本可以具有不同的行为方式。

如果一个 UltraLite 远程数据库在与 UL_SYNC_ALL 进行同步，则将使用 'unknown' 这一发布名称调用此事件一次。

generation_number 参数专用于基于文件的下载。世代号的输出值从 begin_publication 脚本传递到 end_publication 脚本。generation_number 的意义取决于是否在使用当前同步来创建一个下载文件，或者当前同步是否具有上载。

在基于文件的下载中，世代号的更改用于强制在下载之前进行上载。在世代号保持不变的情况下，远程数据库可以处理许多基于文件的下载而无需上载。该编号存储在下载文件中。在包含上载的同步过程中，将为每个发布预订输出一个世代号。这些世代号在上载确认中被发送给远程数据库，并存储于 SYSSYNC.generation_number 中。

• 脚本参数
• 脚本添加和删除
• end_publication 连接事件
• MobiLink 基于文件的下载
• MobiLink 世代号
• 脚本中的远程 ID 和 MobiLink 用户名
• 脚本中的上次下载时间

您可能要为每个正被同步的发布记录该信息。以下示例调用 ml_add_connection_script，将事件指派给名为 RecordPubSync 的存储过程。

CALL ml_add_connection_script(
 'version1',
 'begin_publication',
 '{CALL RecordPubSync( 
    {ml s.generation_number}, 
    {ml s.username}, 
    {ml s.publication_name}, 
    {ml s.last_publication_upload}, 
    {ml s.last_publication_download}, 
    {ml s.subscription_id} )}' );

以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 beginPublication 的 Java 方法注册为 begin_publication 连接事件的脚本。

CALL ml_add_java_connection_script( 
 'ver1',
 'begin_publication',
 'ExamplePackage.ExampleClass.beginPublication' )

以下是 Java 方法 beginPublication 示例。它保存每个发布的名称供以后使用。

package ExamplePackage; 
public class ExampleClass
{
    java.util.ArrayList<String> _publicationNames;
    int				_numPublications = 0;

    public void beginPublication( ianywhere.ml.script.InOutInteger	generation_number,
				  String				user,
				  String				pub_name ) 
    {
	_numPublications++;
	_publicationNames.add( pub_name );
    }
}

以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 BeginPub 的 .NET 方法注册为 begin_publication 连接事件的脚本。

CALL ml_add_dnet_connection_script( 
 'ver1',
 'begin_publication',
 'TestScripts.Test.BeginPub'
)

以下是 .NET 方法 BeginPub 示例。它保存每个发布的名称供以后使用。

using System.Collections.Generic;
namespace TestScripts
{
    class Test
    {
	List<string>	_publicationNames = new List<string>();
	int		_numPublications  = 0;

	public void BeginPub( ref int	generation_number,
			      string	user,
			      string	pub_name ) 
	{
	    _numPublications++;
	    _publicationNames.Add( pub_name );
	}
    }
}