...
We also have the help and usage goal to support users directly on the commandline.
The main use case for us us is to created related issues. If we have a new feature with our Doctype Maven Plugin that generates a new artifact into existing doctype add-ons or fixes a bug on generated artifacts, then users of these add-ons need to be informed. This is typically done by adding a new issue to the individual doctype add-on projects, explaining briefly that this new feature exists or an issue has been solved. With this plugin the related issues can be created automatically, link to the root issue, and be set to a fixed state. No manual steps involved.
Section |
---|
|
So here are some usage examples with goals of this plugin. Caution Box |
---|
| Use -DdryRun to check what will be executed and changed on JIRA without actually changing anything! |
Section |
---|
| Run Code Block |
---|
language | text |
---|
theme | Midnight |
---|
| mvn smartics-jira:versions |
on a project to add the current version and the next micro, minor, and major version on JIRA. For instance, if your project is currently in version 2.3.1-SNAPSHOT , running the above command will ensure that the related project (identified with the issue management in your project's POM) on your JIRA server will have versions 2.3.1 , 2.3.2 (next micro), 2.4.0 (next minor), and 3.0.0 (next major) configured. If any version already exists, that's fine. If not, it will be created. |
Section |
---|
| Run Code Block |
---|
language | text |
---|
theme | Midnight |
---|
| mvn smartics-jira:sync |
on a project to check the differences in name, description, and URL between this information in the POM and on the JIRA project. |
Section |
---|
title | Create dependent Issues |
---|
| Run Code Block |
---|
language | text |
---|
theme | Midnight |
---|
| mvn smartics-jira:issues -DrootIssue=MYPROJ-1 -DprojectKeys=MYOTHERPROJ1,MYOTHERPROJ2 |
to create dependent issues in upstream projects. This is useful if a change in one project has positive effect, like fixing a bug or adding a new feature, without the other projects needing to be touched. Note Box |
---|
title | Local and global Parameter Names |
---|
| Note that each parameter you specify on the command line may be made unique with the prefix smartics-jira (e.g. smartics-jira.projectKeys ). To keep the command line short, the prefix is not necessary. |
|
|
...