Modifying the Login Configuration Attributes Globally

An administrator can change the appearance of the Aptify Login dialog and other system areas for all users by modifying the attributes in the Startup.exe.config file or in Aptify Shell.exe.config and updating the file in the Aptify Object Repository. (To change the configuration attributes for a specific user, modify the Attributes.xml file instead; see Modifying the Login Configuration Attributes Locally for details.)

Follow these steps to modify the configuration attributes in Startup.exe.config or Aptify Shell.exe.config:

  1. Log in to Aptify using the default login dialog if you have not previously logged in as this user.
    • When a user connects to Aptify from a client computer for the first time, the client downloads new copies of all of the relevant Object Repository Objects, including Startup.exe.config and Aptify Shell.exe.config
  2. Locate the Startup.exe.config or Aptify Shell.exe.config file on your client computer (typically located in C:\Program Files\Aptify 5.0).
  3. Right-click the file and select Properties from the pop-up menu to open the Windows Properties dialog for this file.
  4. If necessary, clear the Read-only option.
    • The config files may be read-only by default. 
  5. Click OK to close the file's Properties dialog.
  6. Open Startup.exe.config or Aptify Shell.exe.config using a text editor, such as Notepad.
    • The figure below displays the default contents of the Startup.exe.config file's appsettings section that controls the dialog's appearance and the client's login behavior.
    • This file also contains configuration settings for Exception Management. See Configuring the Exception Manager for more details.
    • This file also contains configuration settings for Attribute Management.

      Startup.exe Configuration File
  7. Edit the property or value of any existing properties.
    • For example, if you want to specify the Aptify server, enter the server name between the two quotation marks, as illustrated below. 
      <add key="Aptify.Framework.LoginServices.AptifyLogin.Server" value="server_name"/>
    • Or, if you want to specify a suggested server (so that the user has the opportunity to overwrite it), replace Server with SuggestedServer and enter the server name as the value:

      <add key="Aptify.Framework.LoginServices.AptifyLogin.SuggestedServer" value="server_name"/>
    • With the exception of the RemoteServer properties (such as Aptify.Framework.LoginServices.AptifyConnectionState.RecentServer01), do not configure any of the AptifyConnectionState properties in Startup.exe.config. These values are set automatically by the Aptify Connection State dialog on a client-by-client basis in Attributes.xml
  8. Add new properties, as necessary.
    • See About the User Login Configuration Attributes for a list of commonly used properties. With the exception of LoginCaption (which is Aptify.Framework.LoginServices.AptifyLogin.LoginCaption), all of the properties listed in that topic are included in Startup.exe.config or Aptify Shell.exe.config by default.
    • Add one line for each new property in the configuration file's appsettings section.
    • Use the following format to specify new properties: 

      <add key="Aptify.Framework.LoginServices.class_name.property_name" value="property_value"/>
    • Refer to the Aptify Software Development Kit (SDK) for information on the LoginServices classes and properties. 
  9. Save the file and close it.
  10. Update the file in the Aptify Object Repository. See Updating Object Repository Objects for details.


Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.