Settings / Administration
- Samuel Weiss
In the settings you can decide how and when issues are created.
There are small differences between the two project types. Service Management has a few settings in addition.
Jira Software Project
Before you can start to register certificates you are tasked to complete and save the settings.
Issue creation settings
Following fields are available:
Create issue x days before expiry: this number defines when the issue is created. The default is 4 weeks. It requires a value between 0 and 90.
Issue or request: For Software project there is only issue.
Issue type: Please select the appropriate issue type from the dropdown, which offers all the available issue types form your project.
Issue summary
Issue description
As indicated for “Issue summary” and “Issue Description”, the usage of certificate variables is possible and allows the creation of meaningful outputs.
Available are: {{commonName}} {{alternateName}} {{issuer}} {{issuerCN}} {{validFrom}} {{validUntil}} {{notes}}
Jira additional fields mappings and values
This section enables you to add additional fields (simple custom fields) and values that you wish to populate. As a standard for software projects, the setting is pre-populated with the 'Due date'.
For text fields you can use again the variables from above.
For date fields you have the option to populate them dependant from the date certificate variables like validUntil.
Dates can be manipulated with 'minusDays' and 'plusDays' after the date variable.
{{ validUntil | minusDays: 7 }} means one week before ‘validUntil’ from the certificate
For testing purposes of your settings you do not need to wait until an certificate expires, you can use the button ‘Create test issue’ at the bottom of the form.
Please do not forget to press 'Save' when done.
Import & Export
The app allows in the import & export tab to download all data and settings as json file.
You can also upload data in the same structure. Please be aware that your data is only overwritten with the import, the certificates based on their uuid. It does not delete any data.
Jira Service Management
Before you can start to register certificates you are tasked to complete and save the settings.
Issue creation settings
Following fields are available:
Create issue x days before expiry: this number defines when the issue is created. The default is 4 weeks. It requires a value between 0 and 90.
Issue or request: In the context of service management projects, users have the option to select either ‘issue’ or ‘request’. This defines if it creates for the certificate renewal an issue or a service request.
Request type: Please select the request type you want to use for certificate renewals.
Issue type: Please select the issue type you want to use for certificate renewals.
Issue summary
Issue description
As indicated for “Issue summary” and “Issue Description”, the usage of certificate variables as well as the name or the organisation is possible to create meaningful outputs.
Available are: {{organisation}} {{commonName}} {{alternateName}} {{issuer}} {{issuerCN}} {{validFrom}} {{validUntil}} {{notes}}
Jira additional fields mappings and values
This section enables you to add additional fields (simple custom fields) and values that you wish to populate. For service management projects following fields are pre-populated:
Organisation
Affected services
Planned start
Planned end
Additional fields values
For text fields you can use again the variables from above.
Jira API
Unfortunately Jira does not allow apps to use internally the APIs offering ‘affected services’. We found a workaround by using the official public APIs. For this you have to provide a valid API key as instructed on the page.
Import & Export
The app allows in the import & export tab to download all data and settings as json file.
You can also upload data in the same structure. Please be aware that your data is only overwritten with the import, the certificates based on their uuid. It does not delete any data.