Mobile Link ユーザ名を指定します。

パラメータ

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

デフォルトのアクション

なし

備考

Mobile Link サーバは、ユーザ名をパラメータとして指定します。このパラメータによってスクリプトが呼び出され、Mobile Link クライアントからユーザ名が送信されます。必要に応じて、代替ユーザ名を作成することもできます。このスクリプトを使用すると、Mobile Link スクリプトの呼び出しで使用するユーザ名を変更できます。

username パラメータは、ユーザ名を格納するのに十分な長さでなければなりません。

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

参照

• スクリプトのパラメータ
• スクリプトの追加と削除
• authenticate_user 接続イベント
• authenticate_user_hashed 接続イベント
• スクリプトでのリモート ID と Mobile Link ユーザ名の使用

SQL の例

次の例は、マッピング・テーブル user_device を使用して、リモート・データベースのユーザ名をデバイスを使用しているユーザの ID にマッピングします。この方法は、同じ人物が複数のリモート (PDA やラップトップなど) を所有し、(ユーザの名前または ID に基づいて) 同じ同期論理が必要なときに使用できます。

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

CALL ml_add_connection_script(
 'ver1',
 'modify_user',
 'call ModifyUser( {ml s.username} )' )

次の SQL 文は ModifyUser ストアド・プロシージャを作成します。

CREATE PROCEDURE ModifyUser( INOUT u_name varchar(128) )
BEGIN
 SELECT user_name
    INTO u_name
    FROM user_device
    WHERE device_name = u_name;
END

Java の例

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

CALL ml_add_java_connection_script(
   'ver1',
   'modify_user',
   'ExamplePackage.ExampleClass.modifyUser' )

次に示すのは、サンプルの Java メソッド modifyUser です。このメソッドは、データベースからユーザ ID を取得し、それを使用してユーザ名を設定します。

public String modifyUser( 
  InOutString ioUserName )
  throws SQLException {
  Statement uidSelect = curConn.createStatement();
  ResultSet uidResult = uidSelect.executeQuery(
   "SELECT rep_id FROM SalesRep WHERE name = '" +
   ioUserName.getValue() + "' " );
  uidResult.next();
  ioUserName.setValue(
   java.lang.Integer.toString(uidResult.getInt( 1 ));
   uidResult.close();
   uidSelect.close();
  return ( null );
}

.NET の例

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

CALL ml_add_dnet_connection_script(
  'ver1',
  'modify_user',
  'TestScripts.Test.ModUser'
)

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

public string ModUser( 
  string user ) {
  return ( "SELECT rep_id FROM SalesRep WHERE name = '" + user + "' " );
}