Working with other capabilities
Most of what makes Forms worth having in the suite comes from what sits next to it. This page is the summary; each connection has its own page with the detail.
Where a connection does not exist, it is listed as such rather than left out, so you can stop looking.
#Every connection
Connects to | What you get |
|---|---|
Where a response lives | In the page's own content. Save writes each field's answer back into that Input macro's stored parameters in the page document, as the signed-in user. Responses therefore inherit Confluence page permissions exactly and travel with a page copy. |
Page content property {appHash}_capable_forms | A mirrored, read-only index on the page holding, per Form ID: the form name, a map of field snapshots keyed by field ID (label, input type, text value, list value), plus updatedAt and updatedBy. Rebuilt immediately after a successful Form Save and again from page and blog-post create/update events. |
CQL search field {appHash}_capable_forms_form_ids | A genuine Confluence search alias declared by both apps, shown in the Capable CQL editor as "Forms on page (ids)" with operators = and IN. The literal field name embeds the app hash, so it DIFFERS between the standalone Forms app and the Suite - a saved CQL search does not carry over when a customer |
Confluence labels | Forms adds Confluence global labels to customers' pages as the app: capable_forms_page on every page carrying a form, plus one capable_forms_{formId} per form. Labels matching that prefix that Forms no longer wants are deleted. Only labels matching those patterns are ever touched. |
Site-wide Form ID registry | A tenant-wide index of distinct Form IDs holding form name, page count and last seen. Diffed per page: adding a form increments the count, removing it decrements, and the entry is deleted at zero. This is what feeds the catalogue's All forms table. |
Confluence global page "Capable Forms" | The global page that hosts the Forms catalogue. Reachable by unlicensed and anonymous visitors, who get the static Capable visitor notice instead of the catalogue. |
Confluence space page "Capable Forms" | The same catalogue opened inside a space, where the responses table is scoped to that space. Also reachable by unlicensed and anonymous visitors, who get the visitor notice. |
Capable Sites static export | A published Capable Site renders both macros as READ-ONLY, disabled HTML controls: text, long text, number, radio, checkbox and select all render disabled with their saved values; a URL field renders as a plain link (an unsafe stored URL is never made into a live anchor); and user, space and page fi |
Usage metric | Every successful Form Save records a business usage metric for the Forms capability. |
Server surface | Exactly two operations exist: save the fields on a page, and list the Form ID registry. Both require a signed-in account; an anonymous caller is rejected. |
#The pages
Where a response lives
One connection.
Page content property {appHash}_capable_forms
One connection.
CQL search field {appHash}_capable_forms_form_ids
One connection.
Confluence labels
One connection.
Site-wide Form ID registry
One connection.
Confluence global page "Capable Forms"
One connection.
Confluence space page "Capable Forms"
One connection.
Capable Sites static export
One connection.
Usage metric
One connection.
#A few things worth knowing
A connection needs both halves installed. In a standalone app most of these do not exist.
Anything that depends on search only reflects pages that have been indexed.
Published sites render Capable macros properly, which is where several of these pay off.
#Related
Better with company.
