Skip to content

Commit 5189204

Browse files
committed
Change JIRA to Jira
1 parent 1368e2d commit 5189204

18 files changed

+84
-84
lines changed

README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Icinga Module for JIRA®
1+
# Icinga Module for Jira®
22

33
[![PHP Support](https://img.shields.io/badge/php-%3E%3D%207.0-777BB4?logo=PHP)](https://php.net/)
44
![Build Status](https://github.com/icinga/icingaweb2-module-jira/workflows/PHP%20Tests/badge.svg?branch=master)
@@ -9,21 +9,21 @@
99
Hassle-free deep integration with Atlassian Jira®. Depending on your needs, this
1010
module is able to:
1111

12-
* create **JIRA Issues for Problems** detected by Icinga
12+
* create **Jira Issues for Problems** detected by Icinga
1313
* create **only one** issue per problem
14-
* **acknowledge** Icinga Problems once a JIRA issue has been created
15-
* manually create Host- or Service-related JIRA issues
16-
* shows a Host/Service-related **JIRA Issue History**
14+
* **acknowledge** Icinga Problems once a Jira issue has been created
15+
* manually create Host- or Service-related Jira issues
16+
* shows a Host/Service-related **Jira Issue History**
1717

18-
And there is more. Use custom templates to trigger JIRA **Workflows** according
19-
your very own needs. This way you can automatically fill JIRA custom fields
18+
And there is more. Use custom templates to trigger Jira **Workflows** according
19+
your very own needs. This way you can automatically fill Jira custom fields
2020
based on monitored system properties. This feature is mostly being used to
2121
assign monitored objects to their **related CIs** or to trigger dedicated
2222
**customer-related workflows**.
2323

2424
This is 100% free Open Source Software. Interested? Then let's [get started](doc/01-Introduction.md)!
2525

26-
![JIRA integration](doc/screenshot/issue_list_and_details-new.png)
26+
![Jira integration](doc/screenshot/issue_list_and_details-new.png)
2727

2828
Changes
2929
-------
@@ -35,7 +35,7 @@ Changes
3535

3636
### v1.2.1
3737

38-
* FIX: Creating tickets in JIRA now works again (#77)
38+
* FIX: Creating tickets in Jira now works again (#77)
3939

4040
### v1.2.0
4141

@@ -52,11 +52,11 @@ Changes
5252
* FIX: we're sending Content-Length to make proxies happy (#51)
5353
* FEATURE: Show status for created issues (#44)
5454
* FEATURE: Allow choosing a default template (#36)
55-
* FEATURE: Add configurable duedate for created JIRA issues (#37)
55+
* FEATURE: Add configurable duedate for created Jira issues (#37)
5656

5757
### v1.0.1
5858

59-
* FIX: Ticket URLs pointing to JIRA for Setups sitting in the DocumentRoot (#30)
59+
* FIX: Ticket URLs pointing to Jira for Setups sitting in the DocumentRoot (#30)
6060
* FIX: The new HTTP/HTTPS scheme setting didn't work (#30)
6161
* FIX: There still was a dependency on Icinga Director (#28)
6262
* FIX: Form for manually created issues didn't work without Icinga Director (#27)

application/clicommands/SendCommand.php

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,10 @@ class SendCommand extends Command
2727
*
2828
* REQUIRED OPTIONS
2929
*
30-
* --project <project-name> JIRA project name, like "ITSM"
31-
* --issuetype <type-name> JIRA issue type, like "Incident"
32-
* --summary <summary> JIRA issue summary
33-
* --description <description> JIRA issue description text
30+
* --project <project-name> Jira project name, like "ITSM"
31+
* --issuetype <type-name> Jira issue type, like "Incident"
32+
* --summary <summary> Jira issue summary
33+
* --description <description> Jira issue description text
3434
* --state <state-name> Icinga state
3535
* --host <host-name> Icinga Host name
3636
*
@@ -41,7 +41,7 @@ class SendCommand extends Command
4141
* It can be a date or time difference in textual datetime format.
4242
* --template <template-name> Template name (templates.ini section)
4343
* --ack-author <author> Username shown for acknowledgements,
44-
* defaults to "JIRA"
44+
* defaults to "Jira"
4545
* --no-acknowledge Do not acknowledge Icinga problem
4646
* --command-pipe <path> Legacy command pipe, allows to run without
4747
* depending on a configured monitoring module
@@ -60,7 +60,7 @@ public function problemAction()
6060
$host = $p->shiftRequired('host');
6161
$service = $p->shift('service');
6262
$tplName = $p->shift('template');
63-
$ackAuthor = $p->shift('ack-author', 'JIRA');
63+
$ackAuthor = $p->shift('ack-author', 'Jira');
6464
$ackPipe = $p->shift('command-pipe');
6565
$status = $p->shiftRequired('state');
6666
$description = $p->shiftRequired('description');
@@ -116,12 +116,12 @@ public function problemAction()
116116

117117
$key = $jira->createIssue($template->getFilled($params));
118118

119-
$ackMessage = "JIRA issue $key has been created";
119+
$ackMessage = "Jira issue $key has been created";
120120
} else {
121121
$key = $issue->key;
122122
$icingaStatus = $config->get('key_fields', 'icingaStatus', 'icingaStatus');
123123
$currentStatus = isset($issue->fields->$icingaStatus) ? $issue->fields->$icingaStatus : null;
124-
$ackMessage = "Existing JIRA issue $key has been found";
124+
$ackMessage = "Existing Jira issue $key has been found";
125125
if ($currentStatus !== $status) {
126126
$update = new IssueUpdate($jira, $key);
127127
$update->setCustomField($icingaStatus, $status);

application/controllers/IssuesController.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ protected function showNewIssueForm()
5353
{
5454
$info = $this->requireMonitoringInfo();
5555
$info->setNotificationType('MANUAL'); // Not sure about this, but that's how it used to be
56-
$this->addTitle($this->translate('Create JIRA Issue') . ': %s', $info->getObjectLabel())
56+
$this->addTitle($this->translate('Create Jira Issue') . ': %s', $info->getObjectLabel())
5757
->activateTab();
5858

5959
$form = (new NewIssueForm($this->jira(), $this->getModuleConfig(), $info))

application/forms/Config/ConfigForm.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?php
22

3-
// Icinga Web JIRA Integration | (c) 2023 Icinga GmbH | GPLv2
3+
// Icinga Web Jira Integration | (c) 2023 Icinga GmbH | GPLv2
44

55
namespace Icinga\Module\Jira\Forms\Config;
66

doc/01-Introduction.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
Introduction
22
============
33

4-
This module allows to send notifications to JIRA and integrates nicely into the
4+
This module allows to send notifications to Jira and integrates nicely into the
55
Icinga Web 2 frontend.
66

77
Features
88
--------
99

1010
### NotificationCommand for Icinga
1111

12-
You want to create a JIRA issue for all or some of your Hosts and Services?
12+
You want to create a Jira issue for all or some of your Hosts and Services?
1313
Then this project might be what you're looking for. Sending notifications is
1414
as easy as follows:
1515

@@ -36,7 +36,7 @@ this works.
3636
### Brief issue history overview
3737

3838
Granted access to this module you can get a quick overview showing the most recent
39-
JIRA issues created by Icinga. Read more about [what information](20-Issue-History.md)
39+
Jira issues created by Icinga. Read more about [what information](20-Issue-History.md)
4040
we're going to show.
4141

4242
![Issue list and details](screenshot/issue_list_and_details_small.png)

doc/03-Configuration.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
* Icinga Web 2 modules:
1010
* The `monitoring` or `icingadb` module needs to be configured and enabled.
1111

12-
## Install the Icinga Module for JIRA®
12+
## Install the Icinga Module for Jira®
1313

1414
Install it [like any other module](https://icinga.com/docs/icinga-web-2/latest/doc/08-Modules/#installation).
1515
Use `jira` as name.
@@ -49,11 +49,11 @@ url = "https://icinga.example.com/icingaweb2"
4949
```
5050

5151
The `port` and `path` settings are optional, protocol is always HTTPS. The
52-
given user needs permissions to create (and show) issues in at least one JIRA
52+
given user needs permissions to create (and show) issues in at least one Jira
5353
project.
5454

5555
If you want to have links pointing back to your Icinga Installation in your
56-
JIRA issues, you need to fill the `url` setting.
56+
Jira issues, you need to fill the `url` setting.
5757

5858
The `ui` section allows to optionally pre-select a specific project and/or a
5959
specific issue type in the "Create New Issue" form. Please note that those
@@ -71,9 +71,9 @@ afterwards:
7171

7272
systemctl restart icinga2.service
7373

74-
### Required JIRA Custom Fields
74+
### Required Jira Custom Fields
7575

76-
This module requires you to create two custom fields in JIRA:
76+
This module requires you to create two custom fields in Jira:
7777

7878
* `icingaKey`: a searchable text field
7979
* `icingaStatus`: a short text field, 12 characters are enough
@@ -85,7 +85,7 @@ this field is going to be used.
8585

8686
This module uses `icingaKey` to figure out whether an issue for the given object
8787
already exists. Hosts use their host name, services use hostname!servicename.
88-
As JIRA seems to offer no exact search for custom text fields out of the box (at
88+
As Jira seems to offer no exact search for custom text fields out of the box (at
8989
least not without installing extra plugins), we are cheating. Search is down via
9090
`~` and we add surrounding escaped double quotes. Still, this doesn't seem to be
9191
enough. So we prefix the key with `BEGIN` and postfix it with `END`.
@@ -98,7 +98,7 @@ following JQL construct:
9898
A little bit weird, but it should work fine. And as this field is usually not
9999
shown anywhere, it shouldn't disturb.
100100

101-
### Fill JIRA Custom Fields
101+
### Fill Jira Custom Fields
102102

103103
> **Hint**: This is optional, do not blindly copy & paste. Use this as an
104104
> example in case you need to feed different workflows with special paprameters.

doc/10-Notifications.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Sending Notifications
22
=====================
33

4-
This is what your monitoring software should call to send a notification to JIRA:
4+
This is what your monitoring software should call to send a notification to Jira:
55

66
icingacli jira send problem \
77
--host some.example.com \
@@ -26,10 +26,10 @@ icingacli jira send problem [options]
2626
2727
REQUIRED OPTIONS
2828
29-
--project <project-name> JIRA project name, like "ITSM"
30-
--issuetype <type-name> JIRA issue type, like "Incident"
31-
--summary <summary> JIRA issue summary
32-
--description <description> JIRA issue description text
29+
--project <project-name> Jira project name, like "ITSM"
30+
--issuetype <type-name> Jira issue type, like "Incident"
31+
--summary <summary> Jira issue summary
32+
--description <description> Jira issue description text
3333
--state <state-name> Icinga state
3434
--host <host-name> Icinga Host name
3535
@@ -38,7 +38,7 @@ OPTIONAL
3838
--service <service-name> Icinga Service name
3939
--template <template-name> Template name (templates.ini section)
4040
--ack-author <author> Username shown for acknowledgements,
41-
defaults to "JIRA"
41+
defaults to "Jira"
4242
--no-acknowledge Do not acknowledge Icinga problem
4343
--command-pipe <path> Legacy command pipe, allows to run without
4444
depending on a configured monitoring module
@@ -55,35 +55,35 @@ Icinga 2 NotificationCommand
5555
In Icinga 2, a related `NotificationCommand` definition could look as follows:
5656

5757
```
58-
object NotificationCommand "JIRA Host Notification" {
58+
object NotificationCommand "Jira Host Notification" {
5959
import "plugin-notification-command"
6060
command = [ "/usr/bin/icingacli", "jira", "send", "problem" ]
6161
arguments += {
6262
"--ack-author" = {
63-
description = "This author name will be used when acknowledging Icinga problems once a JIRA issue got created"
63+
description = "This author name will be used when acknowledging Icinga problems once a Jira issue got created"
6464
value = "$jira_ack_author$"
6565
}
6666
"--command-pipe" = {
6767
description = "Legacy Icinga command pipe. Should only be used on Icinga 1.x system without a correctly configured Icinga Web 2 monitoring module"
6868
value = "$jira_command_pipe$"
6969
}
7070
"--description" = {
71-
description = "JIRA issue description"
71+
description = "Jira issue description"
7272
required = true
7373
value = "$jira_description$"
7474
}
7575
"--host" = "$host.name$"
7676
"--issuetype" = {
77-
description = "JIRA issue type (e.g. Incident)"
77+
description = "Jira issue type (e.g. Incident)"
7878
required = true
7979
value = "$jira_issuetype$"
8080
}
8181
"--no-acknowledge" = {
82-
description = "D not acknowledge Icinga problems once a JIRA issue got created"
82+
description = "D not acknowledge Icinga problems once a Jira issue got created"
8383
value = "$jira_no_acknowledge$"
8484
}
8585
"--project" = {
86-
description = "JIRA project name (e.g. ITSM)"
86+
description = "Jira project name (e.g. ITSM)"
8787
required = true
8888
value = "$jira_project$"
8989
}
@@ -92,12 +92,12 @@ object NotificationCommand "JIRA Host Notification" {
9292
value = "$host.state$"
9393
}
9494
"--summary" = {
95-
description = "JIRA issue summary"
95+
description = "Jira issue summary"
9696
required = true
9797
value = "$jira_summary$"
9898
}
9999
"--template" = {
100-
description = "Issue template name (templates.ini section). This allows to pass custom fields to JIRA"
100+
description = "Issue template name (templates.ini section). This allows to pass custom fields to Jira"
101101
value = "$jira_template$"
102102
}
103103
}
@@ -110,35 +110,35 @@ Host- and Service-NotificationCommands need distinct command definitions, so her
110110
is what it would look like for a Service:
111111

112112
```
113-
object NotificationCommand "JIRA Service Notification" {
113+
object NotificationCommand "Jira Service Notification" {
114114
import "plugin-notification-command"
115115
command = [ "/usr/bin/icingacli", "jira", "send", "problem" ]
116116
arguments += {
117117
"--ack-author" = {
118-
description = "This author name will be used when acknowledging Icinga problems once a JIRA issue got created"
118+
description = "This author name will be used when acknowledging Icinga problems once a Jira issue got created"
119119
value = "$jira_ack_author$"
120120
}
121121
"--command-pipe" = {
122122
description = "Legacy Icinga command pipe. Should only be used on Icinga 1.x system without a correctly configured Icinga Web 2 monitoring module"
123123
value = "$jira_command_pipe$"
124124
}
125125
"--description" = {
126-
description = "JIRA issue description"
126+
description = "Jira issue description"
127127
required = true
128128
value = "$jira_description$"
129129
}
130130
"--host" = "$host.name$"
131131
"--issuetype" = {
132-
description = "JIRA issue type (e.g. Incident)"
132+
description = "Jira issue type (e.g. Incident)"
133133
required = true
134134
value = "$jira_issuetype$"
135135
}
136136
"--no-acknowledge" = {
137-
description = "D not acknowledge Icinga problems once a JIRA issue got created"
137+
description = "D not acknowledge Icinga problems once a Jira issue got created"
138138
value = "$jira_no_acknowledge$"
139139
}
140140
"--project" = {
141-
description = "JIRA project name (e.g. ITSM)"
141+
description = "Jira project name (e.g. ITSM)"
142142
required = true
143143
value = "$jira_project$"
144144
}
@@ -148,12 +148,12 @@ object NotificationCommand "JIRA Service Notification" {
148148
value = "$service.state$"
149149
}
150150
"--summary" = {
151-
description = "JIRA issue summary"
151+
description = "Jira issue summary"
152152
required = true
153153
value = "$jira_summary$"
154154
}
155155
"--template" = {
156-
description = "Issue template name (templates.ini section). This allows to pass custom fields to JIRA"
156+
description = "Issue template name (templates.ini section). This allows to pass custom fields to Jira"
157157
value = "$jira_template$"
158158
}
159159
}

doc/20-Issue-History.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
Issue History and Details
22
=========================
33

4-
For convenience, this module comes with a nice overview of your created JIRA
4+
For convenience, this module comes with a nice overview of your created Jira
55
issues. It shows your most recent issues, combined with the most important
6-
details. Please note that only issues created by the configured JIRA user will
6+
details. Please note that only issues created by the configured Jira user will
77
be shown.
88

99
Issue History Table
@@ -19,14 +19,14 @@ The Summary column shows issue summary and description, and the last column
1919
shows how long ago the issue has been created. Move the mouse over the shown
2020
time to read the full related creation time with timezone details.
2121

22-
![JIRA issue list](screenshot/issue_list.png)
22+
![Jira issue list](screenshot/issue_list.png)
2323

2424
You can then choose an issue, and you'll provided with some more details. All
2525
comments posted to this issue will be shown. Also, there are and some links
26-
pointing to JIRA (directly to the issue or to it's project) and to the related
26+
pointing to Jira (directly to the issue or to it's project) and to the related
2727
Icinga Host or Service.
2828

29-
![JIRA issue details](screenshot/issue_details.png)
29+
![Jira issue details](screenshot/issue_details.png)
3030

3131

3232
Monitoring module hook

0 commit comments

Comments
 (0)