Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

Target audience:

CAST AI Administrators

Summary: this page describes how to change the template email that is created when a user uses one of the "Can't access" options on the login screen of the Health Dashboard or Engineering Dashboard.

If for any reason a user cannot access the Health Dashboard or Engineering Dashboard (they do not have a login or they have forgotten their password), it is possible to configure a "Can't access" link to be displayed on the dashboard login page (by default this link is not enabled - see HD - Dashboard wide configuration options in json and ED - Dashboard wide configuration options in json for more information about enabling this link).

The "Can't access" link offers the users the chance to contact the administrator to request access:

When this option is used, two sub-options are provided:

  • Password lost
  • Request access

For each sub-option, a draft email will be created in the user's default email client requesting a new password or access. The contents of these draft emails are generic, however you can tailor them to your own installation as follows:

  • The contents of the emails are defined in the following file which you should open in a text editor:
Health Dashboard - %CATALINA_HOME%\webapps\CAST-Health\portal\resources\urls.json
Engineering Dashboard - %CATALINA_HOME%\webapps\CAST-Engineering\engineering\resources\urls.json
  • The following script will be displayed:
[
    {
        "id": "login-reset-password",
        "url": "mailto:cast_administrator@customer.com",
        "params": {
            "subject": "CAST Health Dashboard: Password lost",
            "body": "Hi, I forgot my password. \nCan you send me the password linked to the UserName '$login-userlost'. \nRegards."
        }
    },
    {
        "id": "login-request-access",
        "url": "mailto:cast_administrator@customer.com",
        "params": {
            "subject": "CAST Health Dashboard: Request access",
            "body": "Hi, I would like to connect to the Dashboard. \nCan I have a username and password, please? \nRegards."
        }
    }
]
  • The script is fairly straightforward and you can adapt it to your own environment:
idPlease avoid altering this value.
urlThis value governs the destination email address to which the email will be sent. Change this to match your local environment, but please respect the syntax.
params: subjectThis value governs the text that will appear in the subject line of the draft email.
params: body

This value governs the text displayed in the body of the email:

  • Carriage returns (if you require them) must be entered using the "\n" character combination.
  • The $login-userlost value will automatically enter the username as provided by the user attempting to access the dashboard.
  • Following any changes you make, save the urls.json file and then restart your application server so that the changes are taken into account.
Please be very careful how you modify this file. Any change to the structure or the accidental removal of part of the file could render your dashboard inoperative.
  • No labels