begin_synchronization (Verbindungsereignis)

In der folgenden Tabelle stellt die Beschreibung den SQL-Datentyp bereit. Wenn Sie Ihr Skript in Java oder .NET schreiben, müssen Sie den entsprechenden Datentyp benutzen. Siehe SQL-Java-Datentypen und SQL-.NET-Datentypen.

In SQL-Skripten können Sie Ereignisparameter mit ihrem Namen oder mit einem Fragezeichen angeben. Die Verwendung von Fragezeichen ist veraltet und es wird empfohlen, benannte Parameter zu verwenden. Sie können nicht Namen und Fragezeichen in einem Skript mischen. Wenn Sie Fragezeichen verwenden, müssen die Parameter in der nachfolgend gezeigten Reihenfolge stehen und sind nur dann optional, wenn keine nachfolgenden Parameter angegeben wurden (z.B. müssen Sie Parameter 1 verwenden, wenn Sie Parameter 2 verwenden möchten). Wenn Sie benannte Parameter verwenden, können Sie beliebige Teilmengen der Parameter in beliebiger Reihenfolge angeben.

Parametername für SQL-Skripten	Beschreibung	Reihenfolge (veraltet für SQL)
s.remote_id	VARCHAR(128). Die entfernte ID von MobiLink. Sie können die entfernte ID nur dann referenzieren, wenn Sie benannte Parameter verwenden.	Nicht anwendbar
s.username	VARCHAR(128). Der MobiLink-Benutzername.	1
s.new_remote_id	VARCHAR(128). Die entfernte MobiLink-ID, wenn die entfernte ID in der konsolidierten Datenbank neu ist. Wenn die entfernte ID nicht neu ist, ist der Wert NULL.
s.new_username	VARCHAR(128). Der MobiLink-Benutzername, wenn der Benutzername in der konsolidierten Datenbank neu ist. Wenn der Benutzername nicht neu ist, ist der Wert NULL.

Keine.

Der MobiLink-Server führt dieses Ereignis aus, nachdem er vom MobiLink-Client alle für den Beginn der Synchronisation erforderlichen Daten empfangen hat.

Das Skript begin_synchronization ist bei der Pflege von Statistiken hilfreich. Das Skript end_synchronization wird nämlich auch dann aufgerufen, wenn kein Fehler oder Konflikt vorliegt. Während also die Uploadtransaktion zurückgesetzt wird, werden Statistikdaten beibehalten und gepflegt.

Es ist sinnvoll, den Wert von "username" in einer temporären Tabelle oder Variablen zu speichern, falls Sie in nachfolgenden Skripten mehrmals auf diesen Wert zugreifen wollen.

CALL ml_add_connection_script ( 
  'version1', 
  'begin_synchronization', 
  'set @EmployeeID = {ml s.username}' );

Der folgende Aufruf einer MobiLink-Systemprozedur registriert eine Java-Methode namens beginSynchronizationConnection als das Skript für das Verbindungsereignis begin_synchronization, wenn die Skriptversion ver1 synchronisiert wird.

CALL ml_add_java_connection_script( 
 'ver1',
 'begin_synchronization',
 'ExamplePackage.ExampleClass.beginSynchronizationConnection'
)

Im Folgenden sehen Sie die Java-Beispielmethode beginSynchronizationConnection. Sie speichert den Namen des Synchronisationsbenutzers für die spätere Verwendung.

package ExamplePackage; 
public class ExampleClass {
  String _curUser = null;
public String beginSynchronizationConnection(
  String user ) {  
  _curUser = user;
  return ( null );
}

Der folgende Aufruf einer MobiLink-Systemprozedur registriert eine .NET-Methode namens BeginSync als das Skript für das Verbindungsereignis begin_synchronization, wenn die Skriptversion ver1 synchronisiert wird.

CALL ml_add_dnet_connection_script( 'ver1',
  'begin_synchronization',
  'TestScripts.Test.BeginSync'
)

Im Folgenden sehen Sie die .NET-Beispielmethode BeginSync. Sie speichert den Namen des Synchronisationsbenutzers für die spätere Verwendung.

namespace TestScripts {
public class Test {
  string _curUser = null;     
public string BeginSync( 
  string user ) { 
  _curUser = user;
  return ( null );
}}}

begin_synchronization (Verbindungsereignis)

Parameter

Standardaktion

Bemerkungen

Siehe auch

SQL-Beispiel

Java-Beispiel

.NET-Beispiel