Date: Thu, 28 Mar 2024 20:37:23 +0200 (EET) Message-ID: <1807795059.1067.1711651043680@wiki.vertuna.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_1066_16276384.1711651043632" ------=_Part_1066_16276384.1711651043632 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
In this short tutorial we will show you how to use a Webservice = Object Referencing Field type in ConfiForms
We will configure it to show the data from Jira issue And alternatively = from a Confluence page. So there will be 2 fields of this type in a form
We are configuring a form with 2 fields, one to point at our confluence = and another to point at our Jira instance
jiraRef | pageMetadata |
---|---|
|
|
We also have a Hide Field rule to hide "pageMetadata" as we always want = it to show the current page's metadata
The APIs we use return something like this
And we want to show the "Page title" and the issue type description for = this particular issue, in a table...
Page metadata |
Page title |
Jira issue reference |
Jira issue type description |
---|---|---|---|
70582440 | Using Webservice Object = Referencing Field | JTEST-12 | The sub-task of the issue |
Build like this
And to access "page title" we use the following expression (in the "fiel= d name" parameter of the ConfiForms Field macro) to navigate to a desired p= roperty:
pageMet= adata.title
And to navigate to Jira issue type description we use
jiraRef= .fields.issuetype.description
<h1&= gt;Form</h1> <ac:structured-macro ac:macro-id=3D"8513c626-244c-4d2f-a1c6-20fbfce5b366= " ac:name=3D"confiform" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"formName">myform</ac:parameter> <ac:rich-text-body> <ac:structured-macro ac:macro-id=3D"d66e6cc7-51ec-4b0c-8c68-c74a0a2ae0cc= " ac:name=3D"confiform-entry-register" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"restrictions">confluence-administrators</= ac:parameter> <ac:parameter ac:name=3D"atlassian-macro-output-type">INLINE</ac:p= arameter> <ac:rich-text-body> <p> <br/> </p> </ac:rich-text-body> </ac:structured-macro> <p> <ac:structured-macro ac:macro-id=3D"f2a06e3e-cb74-441b-8c8d-9464178a6887= " ac:name=3D"confiform-field-definition" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"mapping">|key|undefined</ac:parameter> <ac:parameter ac:name=3D"fieldName">jiraRef</ac:parameter> <ac:parameter ac:name=3D"fieldLabel">Jira issue reference</ac:para= meter> <ac:parameter ac:name=3D"values">/rest/api/latest/issue/[entry.jiraRe= f]</ac:parameter> <ac:parameter ac:name=3D"extras">4bb4c41a51f289a07507d50a1b841a4d<= /ac:parameter> <ac:parameter ac:name=3D"type">objectRef</ac:parameter> </ac:structured-macro> </p> <p> <ac:structured-macro ac:macro-id=3D"d5acc738-3bd8-45d2-9c7c-5bcfef6c2f4f= " ac:name=3D"confiform-field-definition" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"mapping">|id|undefined</ac:parameter> <ac:parameter ac:name=3D"fieldName">pageMetadata</ac:parameter> <ac:parameter ac:name=3D"fieldLabel">Page metadata</ac:parameter&g= t; <ac:parameter ac:name=3D"values">/rest/api/content/[entry._page]</= ac:parameter> <ac:parameter ac:name=3D"extras">cfa616dd12ec3374aa15e100bd9e20be<= /ac:parameter> <ac:parameter ac:name=3D"type">objectRef</ac:parameter> </ac:structured-macro> </p> <p> <ac:structured-macro ac:macro-id=3D"731a46a8-1fa0-4e04-b778-55b0c9d63830= " ac:name=3D"confiform-field-definition-rules" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"fieldName">pageMetadata</ac:parameter> <ac:parameter ac:name=3D"action">Hide field</ac:parameter> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> <h1>Table</h1> <ac:structured-macro ac:macro-id=3D"2d84b892-01fa-4aa2-b809-bab871188810= " ac:name=3D"confiform-table" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"formName">myform</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id=3D"033f0763-b490-49d4-87b5-d1e92181d9e0= " ac:name=3D"confiform-field" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"fieldName">pageMetadata</ac:parameter> </ac:structured-macro> </p> <p> <ac:structured-macro ac:macro-id=3D"25d9ea60-cd04-487b-85e5-0746b9aa7b26= " ac:name=3D"confiform-field" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"overrideLabel">Page title</ac:parameter&g= t; <ac:parameter ac:name=3D"fieldName">pageMetadata.title</ac:paramet= er> </ac:structured-macro> </p> <p> <ac:structured-macro ac:macro-id=3D"70e0d971-8419-4690-945d-02d502eb49fb= " ac:name=3D"confiform-field" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"fieldName">jiraRef</ac:parameter> </ac:structured-macro> </p> <p> <ac:structured-macro ac:macro-id=3D"1b4d0a80-e3d8-44ce-ae84-dc5284124648= " ac:name=3D"confiform-field" ac:schema-version=3D"1"> <ac:parameter ac:name=3D"overrideLabel">Jira issue type description&l= t;/ac:parameter> <ac:parameter ac:name=3D"fieldName">jiraRef.fields.issuetype.descript= ion</ac:parameter> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro>