RPC HELP TVistaLogin PromptDivision

From VistApedia
Jump to: navigation, search

PromptDivision Property

Example

Applies to

TVistaLogin class


Declaration

   property PromptDivison: Boolean;

Description

The PromptDivision property is available at run-time only. It should be set to True, if the user should be prompted for Division during Silent Login. The prompt will only occur if the user has multi-division access. This property should be set to False, if the prompt should not be displayed due to the manner in which the application is running. However, if set to False and multi-division access is a possibility, then the application must handle it in another way. For example, the application developer would do the following:

  1. Set Login.PromptDivision to False.
  2. Set the Connected property to True to signon.
  3. On return, check whether the Connected property was set to True or check whether the Login.ErrorText property was non-null (and especially "No Division Selected").
  4. If the connection was successful, there is no problem. Otherwise, proceed to Steps 5 - 8.
  5. Check the Login.MultiDivision property and see if it was set to True (which is what would be expected).
  6. If the Login.MultiDivision property is set to True, then check the Login.DivList property for a list of the available divisions (remember the first entry is the number of entries that follow) and, in whatever method was available to the application, have the user select the correct division.
  7. Set the Login.Division property to the selected Division.
  8. Set the Connected property to True, so the connection would be attempted to be established again.