Jama Connect User Guide

Configure general properties

The general properties need to be configured for all Jama Connect installations. Properties include configuring email, the session timeout value, and any messages you want to display on the login page.

  1. Log in to Jama Connect as the root user.

  2. Select the System properties tab in the Jama System Administration panel, then select Edit in the top, right corner.

    config_general_properties.png
  3. Change any of the following settings.

    • Session timeout — Automatically disconnects idle users after a set time (default is 120 minutes). When a session times out, the user is prompted to log in and their license is released. Recommended when using floating licenses.

    • Enable HTML tag security cleaning — Prevents suspicious HTML tags from being added to new and modified rich text fields and test steps. Doesn’t clean up data retroactively. Enabled by default.

    • SMTP settings — Settings that affect notifications and subscriptions.

      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. Jama Connect supports only Explicit (Opportunistic) SSL/TLS connections for SMTP.

    • Collaboration from Address/IMAP — IMAP must be supported to enable reply-to e-mails in the stream.

      System "From" address

      Enter an address for the system to use when it sends notifications or other system messages (for example, info@mycompany.com).

      Collaboration "From" address

      Must match the email address used for IMAP, so replies to stream emails are sent to the same account that processes 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 different from SMTP. Standard ports are Non-SSL:143, SSL:993.

      IMAP use SSL

      Select Yes to use SSL.

      IMAP user account

      Enter a user account for someone with 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). Must be accessible to the person with the IMAP user account.

      IMAP error

      Folder where IMAP collects parsing issues or errors.

    • Time and date formatting — Set the time to meet the needs of your users.

      Set the time to meet the needs of your users.

      Java and JavaScript do not use the same date-time syntax. Review the difference before setting the values. Some typical formats for JavaScript are m/d/Y h:I a and m/d/Y. Some typical formats for Java are MM/dd/yyyy hh:mm:ss a z and MM/dd/yyyy.

      If you use Windows, enable Adjust for daylight saving time automatically is in Windows Date and time settings so that the time zone is displayed correctly in reviews.

      The Trace View date format is inherited from a different format than other items in the application. 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 — Enables users to perform actions in Jama Connect from outside the user interface.

    • Attachment file extensions — List of file types (lowercase, separated by commas, periods, spaces, or newline characters) that can be uploaded as an attachment.

      Note

      Files are rejected if the content of the file doesn’t match the file extension, or if the MIME type is not understood by the system, even if the file type is listed here. To allow files of an unknown type, set the option to a blank string.

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

    • Notice on login page — Displays a notice to users below the login page and in a yellow bar at the base of the application page.

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

      Note

      This login page might not be visible if you are using SSO or SAML logins.

    • Maintenance mode — Logs out and locks out all users except the root user until this option is disabled.

    • Set header color — Helps to differentiate test or staging instances from the production instance of Jama Connect.

  4. Select Save.