Jama Connect User Guide

Configure general properties
  1. Log in as root user.

  2. To modify general properties, select the System properties tab in the administrative window, then select Edit in the top, right corner.

    config_general_properties.png
  3. Make your changes to any of the following:

    • Session timeout

      This automatically disconnects an idle user after a set time (default 120 minutes). When a session times out, the user will see a pop-up window prompting them to log in. This setting is useful when using floating licenses because it will release licenses from idle users.

    • Enable HTML tag security cleaning

      This will prevents any suspicious HTML tags from being added to new and modified rich text fields and test steps. However, it will not clean up data retroactively. It is enabled by default.

    • SMTP settings

      • SMTP Enabled: Select Yes to use SMTP

      • SMTP Host: The domain address of your SMTP server

      • SMTP Port: The port for SMTP access

      • SMTP User: User account to access SMTP 

      • SMTP Password: Password for the user account 

      • Authorization Required: Select Yes if authorization is required for the SMTP server 

      • Use TLS: Select Yes if your mail server uses TLS

    • Collaboration from Address/IMAP

      Important

      Check with your administrator whether your e-mail server supports IMAP. IMAP must be supported to enable reply-to e-mails in the stream.

      • System "From" address: Enter a an address for the system (for example info@mycompany.com).

      • Collaboration "From" address: This e-mail should match the e-mail address used for IMAP, so that replies to stream e-mails will be sent to the same account that is setup to process the incoming mail (for example replyto@mycompany.com).

      • IMAP enabled: Select Yes to use IMAP and stream emails.

      • IMAP server: Enter the domain address of your email server (for example, imap.gmail.com).

      • IMAP port: The port for IMAP access, typically differs from SMTP. Standard ports are Non-SSL:143, SSL:993.

      • IMAP use SSL: Select Yes to use SSL.

      • IMAP user account: User account must have access to the folder where IMAP emails are saved.

      • IMAP user password: Enter the password for the user account.

      • IMAP folder: Folder where collaboration emails are sent or saved (for example, Inbox). This folder will be parsed on regular intervals and so it must be accessible by the user account.

      • IMAP error folder: A separate error folder must be setup for IMAP to avoid parsing issues (for example, Errors).

    • Time and date formatting

      Set the time to meet the needs of your users.

      Java and JavaScript do not use the same date time syntax so please review a reference prior to setting the values.

      Note

      The Trace View date format is inherited from a different format than other items in the application. In order to match formats, you must have the Javascript Day/Month/Year format and Javascript Date/Time format in the same order. This is most notable when using a European date format.

    • Allow project administrators to add groups

      Select Yes for project administrators to add groups. Otherwise, only system and organization administrators can add groups.

    • Allow project administrators to set project permissions

      Select Yes for project administrators to grant project permissions. Otherwise, only system and organization administrators can grant permissions.

    • Allow access to REST API

      Enable this so that users can perform actions in Jama Connect from outside of the user interface.

    • Attachment file extensions

      This whitelist limits the file types that can be uploaded by users as an attachment. Enter the allowed file extensions as a list, separated with commas, periods, spaces or newline characters.

      Note

      Files will be rejected if the contents of the file do not match the file extension, or if the MIME type is not understood by the system, even if the file type is listed here. You can override this so that files of an unknown type are allowed by setting the option to a blank string.

      Note

      File extensions need to be lowercase even if the actual extension on the file is uppercase. Learn more.

    • Notice on login page

      This is a way for system administrators to provide a notice to users. Enter the desired message (HTML formatting can be used) and it will appear below the login window. It will also appear in a yellow bar at the base of the application window.

      Jama Connect login page with a message at the bottom that says "You can add a custom message that appears here".
    • Maintenance mode

      Enable this feature to log out all users except the root user. All users, except root, remain locked out until this is disabled.

      Note

      However, when reindexing, maintenance mode is enabled automatically, locking users out while the index is being performed. As root user, you can manually disengage maintenance mode here, but it is not recommended. Maintenance mode will automatically turn off when the reindex is completed.

    • Set header color

      This helps to easily differentiate test or staging instances from the production instance of Jama Connect.

  4. Select Save.