Publishing report
- Robert Alexander Marshall
- Comala Publishing for Confluence Cloud
Overview
The publishing report displays the current publishing state of pages in the source and the target spaces. It can be accessed from the source space in the Confluence sidebar Apps menu.
The publishing report allows editors and space administrators in a source space to view the publishing state (the synchronization state) of all the pages in the source and target spaces
You can filter the report's display based on the page's publishing state. When a Comala workflow is applied in the space, the report can also be filtered to display pages in the final state of the workflow that are not currently synced.
You can sort the report table by each column in ascending or descending order.
A space administrator can also publish all the pages displayed in the report and view details of the last space publishing action.
Accessing the publishing report
The publishing report is accessed from the source space Confluence sidebar
choose Apps>Comala Publishing
The default report displayed the states in the source space that are not synced
The default state Not SYNCED option displayed pages with a publishing state of
New
Out of Sync
The publishing report can also be accessed from the top left menu in the Comala Publishing Get Started screen
Space manifests
The publishing report allows editors and space administrators in a source space to view the publishing state (the synchronization state) of all the pages in
the source space
the target space
Source space manifest
The report displays a list of pages in the source space and their publishing state.
The publishing state can be used to filter the source space manifest report:
Any STATE
state NOT SYNCED
When a Comala workflow is applied in the space, the report can also be filtered to display pages in the final state of the workflow that are not currently synced
Final workflow state + Not Synced
If the space has more than 25 pages, use the Load more option to display more pages.
When viewing the report for the source space, a space administrator can publish the pages listed in the report using the Publish pages button.
Target space manifest
Toggle the report using [target]<spacename> to display the publishing state of pages in the target space.
The publishing state can be used to filter the target space manifest report:
Any STATE
state NOT SYNCED
When publishing in the space is configured to use the app add-on user permissions, the target space manifest displays the add-on user in the Last updated by column.
The Publish pages button is disabled when viewing the target space in the report.
Report columns
The report displays the following information for each page in a space.
Page (page title)
State (publishing state)
Last synced by
When (date of last publishing synchronization)
Version (source page version on last publishing synchronization)
Last updated by
When (date of last update in the currently selected space)
Version (current page version in the currently selected space)
The report table can be sorted for each column in ascending or descending order, making it easier to organize and review data
Toggle the report using the space name byline items to view the target space pages.
In the target space report
Last synced by column and related When and Version are data for the source space page that was synced
Last updated by column and related When and Version data are for the target space page
A page in the source space with a New publishing status
is a page that has not been published, or the previously published page has been removed from the target space.
A page in the target space with a Removed publishing state
is a page without a previously published source space page (the source space page may have been deleted after publishing, or the page may have been created directly in the target space).
Filtering the report
By default, the report displays all pages in the source space that are not synced. These are pages in the source space with the publishing state of either
New
Out of sync
Final workflow state + Not Synced
In the target space, a Removed publishing status is displayed for pages whose source space page has been deleted.
Choose Any state to display all the publishing information for all the pages in the space.
Displays pages in the selected space that have any publishing state
New - pages not yet published
Out of sync - previously published pages that are currently out of sync
Synced - pages currently in sync
Removed (only displayed in the target space report) - pages in the target space where the source space page has been deleted
With an applied Comala workflow, you can also choose to filter the report to display pages that are not synced and in the final state of the workflow.
The Workflow in final state + Not Synced report filter is displayed only when a workflow is applied to at least one page in the space. When no workflow is applied, the available report filters are Any state and state Not Synced.
Publishing the report
The Publish pages button publishes the pages currently displayed in the report table.
The number of pages to be published is displayed on the button.
For example, for a publishing report for a source space with the state NOT SYNCED applied that filters to two pages:
Only the two listed pages are published.
Choose Publish to confirm.
The space publishing report is displayed upon completion of the publishing action.
If the publishing report for a space has the Any state filter applied and five pages are displayed, all of the displayed pages are published.
Last publication byline
The Last Publication byline option is displayed in the report if at least one previous whole-space publish action was undertaken using the Space publish option in the space publishing dashboard or the Publish option in the publishing report.
Select the byline to view:
a summary of the last whole space publish action
the See details link to the space publishing report for the last whole space publish action