検索結果をメール経由で受け取る
JIRA enables you to subscribe to an issue filter (a saved search). JIRA will then run the search according to your specified schedule, and will email the results to you.
You can specify when and how often you would like to receive the search results, e.g. 'Every hour between 9.00AM-5.00PM, Monday-Friday', or 'The last Friday of every month at 7.00AM'.
Emails can only be sent if your administrator has configured an SMTP mail server. The filter results will only send the first 200 results of a filter.
On this page:
Subscribing to a Filter
- Choose Issues > Manage Filters.
- A list of available filters is displayed:
- Locate the filter you are interested in and click on its Subscribe link. The Filter Subscription form is displayed:
- In the Recipients box, either choose 'Personal Subscription' (if you only wish to subscribe yourself), or select a group of recipients from the dropdown list.
Note: You cannot select a group unless your JIRA administrator has granted you the 'Manage Group Filter Subscriptions' global permission. - Select one of the following types of schedule:
- Daily — choose this if you want to receive one or more emails every day.
- Days per Week — choose this if you want to receive one or more emails on particular days of every week.
- Days per Month — choose this if you want to receive an email on a particular day of every month.
- Advanced — see Advanced scheduling ('cron') below.
- Click Subscribe.
- You will now be shown a subscription summary page. If you wish, click Run now to test your subscription.
Advanced scheduling ('cron')
You can use a 'Cron Expression' to specify a custom schedule to suit your particular requirements.
Cron expressions consist of the following fields, separated by spaces:
フィールド | 指定可能な値 | Allowed special characters |
---|---|---|
秒 | 0-59 | , - * / |
分 | 0-59 | , - * / |
時間 | 0-23 | , - * / |
日 | 1-31 | , - * / ? L W C |
Month | 1-12 または JAN-DEC | , - * / |
曜日 | 1-7 または SUN-SAT | , - * / ? L C # |
Year (optional) | 1970-2099 | , - * / |
The special characters operate as follows:
特殊文字 | 用途 |
---|---|
, | 値の一覧を指定します。たとえば、曜日フィールドでは、「MON,WED,FRI」は「毎週月、水、金曜日」を意味します。 |
- | 値の範囲を指定します。たとえば、曜日フィールドでは、「MON-FRI」は「毎週月、火、水、木、金曜日」を意味します。 |
* | とりうるすべての値を指定します。たとえば、時間フィールドでは、「*」は「その日の毎時」を意味します。 |
/ | 与えられた値に対する増分を指定します。例えば、分フィールドでは、「0/15」 は「その 1 時間の間で、0 分から開始した場合の 15 分間隔」を意味します。 |
? | 特定の値を指定しません。月 または 曜日の 2 つのフィールドで、一方は値の指定が必要だが、他方は必要でない場合に便利です。 |
L | とりうる値のうち、最後の値を指定します。これは、コンテキストによって違った意味を持ちます。曜日フィールドでは、「L」単体は「各週の最後の日」(「毎土曜日」) を意味します。他の値のあとに使用すると、「月の最後の xxx 曜日」 (たとえば、「SATL」と「7L」はいずれも「月の最後の土曜日」) を意味します。月フィールドでは、「L」単体は「月の最後の日」を意味し、「LW」は「月の最後の平日」を意味します。 |
W | 月の特定の日に最も近い平日 (月曜日 〜 金曜日) を指定します。たとえば、 「1W」 は「その月の 1 日に最も近い平日」を意味します (1 日が土曜日の場合、メールは同月内の 最も近い平日、すなわち 3 日月曜日に送信されます)。「W」は、日の値として、範囲や一覧ではなく単一の日を指定している場合にのみ利用できます。 |
# | 特定の第 n 曜日を指定します。たとえば、「TUES#2」 (または「3#2」) は、「その月の第 2 火曜日」を意味します。 |
Here are some sample cron expressions:
| 毎日午後 8 時 15 分。 |
| 毎日午前 8 時 15 分。 |
| 毎日午後 2 時 00 分から始まり、午後 2 時 59 分が最終となる毎分。 |
| 毎日午後 2 時 00 分から始まり、午後 2 時 55 分からが最終となる 5 分間隔。 |
| 毎日午後 2 時 00 分から始まり、午後 2 時 55 分からが最終となる 5 分間隔、および毎日午後 6 時 00 分から始まり、午後 6 時 55 分からが最終となる 5 分間隔。 |
| 毎日午後 2 時 00 分から始まり、午後 2 時 05 分が最終となる毎分。 |
| 期間指定なしの (永久に続く) 10 分間隔。 |
| 3 月の毎週水曜日の午後 2 時 10 分および午後 2 時 44 分。 |
| 毎週月曜日、火曜日、水曜日、木曜日、金曜日の午前 8 時 15 分。 |
| 毎月 15 日の午前 8 時 15 分。 |
| 毎月最終日の午前 8 時 15 分。 |
| 毎月最後の平日の午前 8 時 15 分。 |
| 毎月最後の金曜日の午前 8 時 15 分。 |
| 毎月第 2 金曜日の午前 8 時 15 分。 |
| 2007 年、 2008 年、2009 年の毎月第 2 金曜日の午前 8 時 15 分。 |
Cron expressions are not case-sensitive
Subscription Context
Each time that a subscription is activated, the saved filter for the subscription is used to find the relevant issues. This search is executed for each user in the group that will receive the subscription email. This means that any filter that uses JQL function such as currentUser()
will be evaluated with a different user each time. This also means that if one user doesn't have permission to see some of the issues returned by the search then the list of issues that they receive in email will be different from other users' email. This has two other consequences:
- If you share a subscription with a group with many members it can take a long time to generate the emails to be sent. This can make JIRA very slow for minutes. This is a good reason be careful with allowing the Manage Group Filter Subscriptions permission.
- If a group contains a user whose email address is actually a distribution list (i,e. a group email alias), then everyone on that distribution list will receive the same email, since JIRA doesn't know who the users on the list are.
Managing Other User's Shared Filters
A shared filter is a filter whose creator has shared that filter with other users. Refer to Sharing a Filter for details. When a shared filter is created by a user, that user:
- 共有フィルターの最初の所有者になります。
- 所有者は、共有フィルターを編集および修正できます。
If you have the 'JIRA Administrators' global permission, you can manage shared filters that were created by other users.
To access the 'Shared Filters' feature:
- Ensure that you are logged in as a user with the JIRA Administrators global permission.
- On the top navigation bar, click the 'Issues' dropdown and select 'Shared Filters' from the list.
- See Managing Shared Filters in the JIRA Administrator's Guide.