Das Skript kann verwendet werden, um den Meldungstext (Fehler, Warnung und Information), der an die entfernten Datenbanken gesendet wird, anzupassen.

Parameter

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. Weitere Hinweise finden Sie unter SQL-Java-Datentypen und SQL-.NET-Datentypen.

In SQL-Skripten können Sie Ereignisparameter mit ihrem Namen oder mit einem Fragezeichen angeben. Namen und Fragezeichen dürfen jedoch in einem Skript nicht gemischt verwendet werden. 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.

Standardaktion

Keine.

Bemerkungen

SQL-Skripten für das Ereignis modify_error_message müssen als gespeicherte Prozeduren implementiert werden.

Siehe auch

• Skriptparameter
• Skripten hinzufügen oder löschen
• Entfernte IDs und MobiLink-Benutzernamen in Skripten verwenden

SQL-Beispiel

Das folgende Beispiel liest alle Daten vom Vortag ein, unabhängig davon, ob die Datenbanken seitdem synchronisiert wurden.

Die folgende SQL-Anweisung erstellt die gespeicherte Prozedur ModifyLastErrorMessage.

CREATE PROCEDURE ModifyLastErrorMessage(
  inout error_message VARBINARY(1024),
  in username VARCHAR(128),
  in error_code INT )
BEGIN
  SELECT dateadd(day, -1, last_download_time )
  INTO last_download_time
END

Der folgende Aufruf einer MobiLink-Systemprozedur weist die Prozedur ModifyLastErrorMessage dem Verbindungsereignis modify_error_message für die Skriptversion modify_ts_test zu:

CALL ml_add_connection_script(
  'modify_ts_test',
  'modify_error_message',
  'CALL ModifyLastErrorMessage ( 
    {ml s.error_message}, 
    {ml s.username}, 
    {ml s.error_code} )' );

Java-Beispiel

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

CALL ml_add_java_connection_script(
  'ver1',
  'modify_error_message',
  'ExamplePackage.ExampleClass.modifyLastErrorMessage' )

Im Folgenden sehen Sie die Java-Beispielmethode modifyLastErrorMessage. Sie druckt die aktuelle Fehlermeldung und den Fehlercode aus.

public String modifyLastErrorMessage(
  String lastErrorMessage,
  String userName,
  int errorCode ) {  
  java.lang.System.out.println( "error message: " +
   lastErrorMessage );
  java.lang.System.out.println( "error code: " +
   String.valueOf(errorCode) );
  return( null ); 
}

.NET-Beispiel

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

CALL ml_add_dnet_connection_script(
  'ver1',
  'modify_error_message,
  'TestScripts.Test.ModifyLastErrorMessage' )

Im Folgenden sehen Sie die .NET-Beispielmethode ModifyLastErrorMessage. Sie druckt den aktuellen Fehlercode und die Fehlermeldung aus.

public string ModifyLastErrorMessage (
  string errorMessage,
  string userName,
  string errorCode  ) {
  System.Console.WriteLine( "error message: " + errorMessage );
  System.Console.WriteLine( "error code: " +  errorCode );
  return ( null );
}