Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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 computer running the Aptify Desktop client 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 or 5.5).
  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 check box in the Attributes section.
    •  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.
  7.  Uncomment the publisher mode attribute from within the exceptionManagement section by removing the <!-- from before and the --> from the end. The line is below:

    No Format
    nopaneltrue
    <publisher mode="on" days="3"  exceptionformat="xml" directory="c:\" assembly="AptifyExceptionManagement" type="Aptify.Framework.ExceptionManagement.XMLFilePublisher"/>

     

    • If the line does not exist, add it between the exceptionManagement tags.

    • When no publishers are defined in the exceptionManagement section, the default publisher is used. The default publisher is the Event Log publisher.

  8.  Configure the settings to fit your organization’s needs.

    • publisher mode: Values are On or Off. When set to On, exceptions are published to that publisher. When set to Off, exceptions are not published to the publisher.
    • days: The length of time that exceptions are logged before a new file is created.
    • exceptionformat: The format of the exception file.Values are xml or exception. The supported format for the default publisher is xml.
    • directory: The location where the file should be logged. Note that all users must have access to the file and file location.
    • assembly: The assembly for this publisher. The default value is AptifyException. However an developer can create a plug-in based on an organization’s needs. 

    • type: The publisher type. The default value is Aptify.Framework.ExceptionManagement.XMLFilePublisher. Aptify 5.5.4 adds support for a database publisher that sends database exceptions to a new entity, Error Log. The type for the database publisher is Aptify.Framework.ExceptionManagement.DatabasePublisher.

      For example, to enable the database publisher, you would enter something similar to the following:

      No Format
      nopaneltrue
      <exceptionManagement mode="on" defaultseverity="0" legacytextformat="true">
          <!--<publisher mode="on" assembly="AptifyExceptionManagement" type="Aptify.Framework.ExceptionManagement.DatabasePublisher"/>-->
      </exceptionManagement>
  9. Save the Startup.exe.config or Aptify Shell.exe.config file.

...