Versions Compared

Key

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

What do I need to get started with Raley Notifications?

If you're in the Cloud version then you will need:

  • Subscription to Cloud JIRA 
  • JIRA Admin permissions to setup our add-on


Cloud JIRA will normally use account with username  addon_net.vacom.jirassimo to interact with your host instance. If there are any access-related errors you can tune it by giving extra permissions to 

addon_net.vacom.jirassimo user

 

If you're using JIRA Server then:

  • JIRA version 7+.  Earlier JIRA versions are not supported
  • A dedicated JIRA user with username "jirassimo". This account will be used by Raley to work with your host JIRA instance and you can finely tune access permissions on it if needed,
  • JIRA Admin or Project Admin permission to access and setup our add-on

How to format JIRA fields?

...

Code Block
#foreach ($issue in $issues)
    $jirassimo.settingValue($issue.fields.customfield_10000)
#end

 

How to use custom scheduled event?

This is another name for scheduled messagingThe whole idea here is that Raley will not react on specific events in your host JIRA, but rather poll it at specific times and send messages about issues that are relevant to JQL.

To save your time, here're the most popular CRON expressions that you might find useful while configuring your own messenger:

Expression
Explanation
0 0 10 ? * MON-FRIRun daily from Monday to Friday at 10AM
0 0 9 1/1 * ? *Run daily at 9AM
0 0 12 1/1 * ? *Run daily at 12AM

 

Our messaging system is implemented in such a way that at the beginning of every hour it checks all custom scheduled messengers to understand which of them are eligible to run during this hour. If specific messenger is eligible, then it will be run right away. You should keep in mind that since messengers are run hourly, then it doesn't make sense to use a CRON expression like this (running messenger every 10 minutes): 

0 0/10 * 1/1 * ? *

If you still do, the corresponding messenger will still run only once per hour.

 

How are run-time errors reported?

Each messenger might return an error generated at runtime. Examples of this errors are:

  • Insufficient privileges in JIRA - for instance, retrieval of related users or projects. 
  • Errors during template evaluation. Some fields might be missing or in wrong format
  • Bad credentials for Email or Slack. 
  • IO related problems

These errors would be normally reported to user on the list of Raley notifications just below the names of respective messengers. When you fix it, assuming that the fix was correct, the error message will disappear next time the current messenger is successfully run.

 

Why do I need "jirassimo" user?

When navigating to Raley configuration screen you might see the following warning:

Image Added

Raley AddOn is relying on existence of this user to handle events with JIRA issues and ServiceDesk requests. Specifically, this user profile is needed to check whether issue can be found by given JQL criteria that was specified in notification. If the user 'jirassimo' is not present, a runtime exception will be thrown. If you're not using JQL criteria for issues notifications then the AddOn will function properly even without this user available.

Also, 'jirassimo' user is needed to run digested notifications when issues are retrieved from JIRA under this user's permissions.

That said, if you need to restrict access of Raley AddOn to specific projects in JIRA you can do that by configuring access permissions on "jirassimo" user.