A nonvisual object generated by the MobiLink Sync User and Subscription Maintenance wizard creates a database connection (with full or limited administration authority) that allows an application user to update MobiLink users and subscriptions in a remote SQL Anywhere database. A wizard screen allows you to set the database authority that you want to provide to the user for these administrative tasks.
Altogether the wizard generates six objects, which are described in Table 16-11. The appname variable in the default name for each object is replaced by the name of your target application. You can change the default names on the Name Generated Objects page of the wizard.
Generated object |
Description |
|---|---|
w_appname_mluser |
Window for entering MobiLink user information, including MobiLink server options that you enable for editing |
w_appname_mlsubscription |
Window for entering MobiLink subscription information, including MobiLink server options that you enable for editing |
nvo_appname_mluser |
Nonvisual user object with functions that connect to the remote database and open the user or subscription maintenance window |
m_appname_mluser |
Menu assigned to the user and subscription maintenance windows with menu items for propagating changes made in those windows |
vo_appname_mluser |
Visual user object included in the user and subscription maintenance windows to display values for MobiLink options and user and subscription information |
d_appname_mluser |
DataWindow included in the visual user object to display values for MobiLink options and user and subscription information |
After you run the wizard, you can assign a global variable to the nonvisual user object generated by the wizard and instantiate the nonvisual object in an application script. You can then call the uf_run_mluser_window function of the instantiated object from the Clicked event of a User Maintenance menu item that you add to one of your application menus. Similarly, you can call the uf_run_mlsub_window function from the Clicked event of a Subscription Maintenance menu item that you add to an application menu.
Calling the functions of the nonvisual user object opens the designated maintenance window and connects to the remote database. Changes that the user makes to either maintenance window are propagated to the remote database by selections in the menu generated by the wizard. The generated menu object is associated with both maintenance windows.
Sample code for performing the post-wizard tasks is included in commented sections of the Script views for the nonvisual object and the two maintenance windows generated by the wizard.
