Work has already started on the new Forms API functionality and we now have some experimental APIs available for use. So now Marketplace Partners can already integrate forms into their products.
For more information, please refer to the features below:
As a workaround to the feature request "Forms Automation: Lock/submit/reopen form on status change", this article is meant to help users who want to use the new experimental features of the Forms API to automatically submit a form or reopen it.
Also, if you are looking for a way to manipulate more than one form, please refer to the article below:
To reopen a form:
- The web method will be a PUT:
PUT https://api.atlassian.com/jira/forms/cloud/{cloudId}/issue/{issueIdOrKey}/form/{formId}/action/reopen
- The cloudId will be your Cloud ID and not your Org ID. The easy way to get the cloud id is to go to https://<instance>.atlassian.net/admin/jira-service-desk/portal-only-customers. You will get the Cloud id in the URL (e.g.: https://admin.atlassian.com/s/<cloud_id>/jira-service-desk/portal-only-customers)
Tip: Don't get confused, the Org ID has a /o/ before the ID (https://admin.atlassian.com/O/<org_id>) and the Cloud ID has a /s/ before the ID (https://admin .atlassian.com/S/<cloud_id>).
- The issue ID or issue Key that you are using. To add the issueId or issueKey dynamically, you can use the smart value {{issue.id}} or {{issue.key}}
- The formId will be in the universally unique identifier "uuid" format. To get it you can use the Forms properties structure below:
https://<yourCloudURL>.atlassian.net/rest/api/2/issue/<issueId>/properties/proforma.forms
- To add the formId dynamically, you can use the smart value below:
{{issue.properties."proforma.forms".forms.uuid}}
- The automation rule will be as shown in the screenshot below:
PUT https://api.atlassian.com/jira/forms/cloud/{cloudId}/issue/{issueIdOrKey}/form/{formId}/action/submit
- The steps will be the same as above and the automation rule will be as shown in the screenshot below:
Note: To call experimental methods the "
X-ExperimentalApi" and "opt-in"
header must be provided on the web request headers.
This workaround will work as shown in the screen recording below:
Bruno Altenhofen
Atlassian Engineer - The guy from ProForma(Jira Forms)
e-Core
23 comments