Page History
Do Raley Emails Notifications store private data as defined by Atlassian.
No, we do not store user's private data
Where are you hosted?
Our servers are located in New York City, US.
Are Raley notifications replacing standard Jira/JSM notifications?
No, our notifications system has nothing in common with Jira/JSM notifications. You can use Raley and Jira/JSM notifications at the same time without conflicting.
Raley does not switch off or modify in any way existing Jira Notification Schemes or JSM Customer notifications
Which servers are sending Emails from Raley?
Emails can be sent from the following IP's:
45.55.218.70
161.35.132.150
138.197.14.52
64.225.21.7
What do I need to get started with Raley Notifications?
...
- Subscription to Cloud JIRA
- JIRA Admin permissions to setup our add-on
...
Templating is difficult... Do you provide example templates?
Yes, please have a look here: Predefined Customer Email Notification templates. Also, you're most welcome to use our Template Wizard
We have another add-on that has to do something before Raley should handle the Jira event. Can you delay your processing?
Yes, we can delay processing of events on your Atlassian instance. Please file us a ticket via support portal https://inversionpoint.atlassian.net/servicedesk/customer/portal/3
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?
...
DateTime fields
By default, JIRA json is returning datetime fields in the following form: 2015-12-10T14:25:20.374+1100 which is fine for computers, but hard to read for humans. With Raley templates you can use a dedicated function to format JIRA dates using the format you prefer.
...
#foreach ($issue in $issues) Project: $issue.fields.project.name Issue type: $issue.fields.issuetype.name Date and time of creation: $jirassimo.formatDate($issue.fields.created, "dd MMM yy hh:mm") Reporter: $issue.fields.reporter.name #end
Numeric fields
To format a numeric JIRA field use $jirassimo.formatNumber(numberField, outputFormat) function. An example of usage:
$jirassimo.formatNumber($issue.customfield_12345, "#")Assuming that customfield_12345 contains a value 10.45 the result will be 10. We use Java DecimalFormat to format the values.
How to use Settings?
Settings is essentially a map of key=value pairs stored with Raley. At runtime you can get a value referenced by key using the following expression:
$jirassimo.settingValue($issue.fields.customfield_10000)This will return a setting's value that corresponds to key stored in $issue.fields.customfield_10000
Check out this article.
Sending to different Slack channels depending on user's email
...
And in your template you just need to resolve a value from settings based on the key at hand. It is as simple as:
| 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 messaging. The whole idea here is that Raley will not react on specific events in your host JIRAJira, 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-FRI | Run 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?
...
- Insufficient privileges in JIRA 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:
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. Also, you can check Send Audit tab and look for the notifications that have Status = Error.
