Swift publication in the Pages app

You can use the usual publication actions from DX Core to publish. The Swift publication actions decorate the existing DX Core actions. The only differences you’ll notice are in the Status column. These are summarized in Publication status.

There are three publishing actions:

  • Publish: Publishes the selected node to the public instance.

  • Publish incl. subnodes: Publishes the selected node and its children to the public instance. This action typically runs asynchronously because it can take a while to publish lots of content.

  • Unpublish: Unpublishes (deactivates) the node from the public instance.

If a parent node isn’t published yet, you can’t publish the child node (the action is grayed out).

Apps typically display the publishing status in the workbench.

Magnolia strongly recommends migrating existing JCR content to Swift storage before publishing any content with Swift publication.

Once content is migrated, you have the possibility to restore previous versions. However, if you create pages and publish them with Swift publication before migrating content, nodes without JCR versions don’t have hasVersion mixin properties. For nodes without JCR versions, you need to create another Swift version to bring back the restore action for that node.

Publication status

Publication status is displayed on each component in the Status column.

Status Description

Publishing status icon - Published Published (solid green circle)

Content was published from the author instance to the public instance. Identical content exists on both instances.

Publishing status icon - In progress In progress (amber circle with a dot)

Content is in the process of being published from the author to public instances. It changes to published when the author instance has received replies from all the public instances.

If a public instance is down when publishing, the status will remain as publishing and catch up with the published items once the public instance is back up again. This differs from DX Core publishing, which doesn’t catch up with older publication requests when a public instance starts. The tooltip of the Status column for this field shows the number of publications completed and the total publication requests.

Publishing status icon - Modified Modified (amber circle with a dot)

Content’s been modified since publication. The author instance is not in sync with the public instance.

Publishing status icon - Unpublished Unpublished (red circle)

Content exists only on the author instance.

Publishing status icon - Error Error (red circle)

An error is generated if the content can’t be published for some reason, for example, because you tried to publish a child page whose parent page was deleted on a public instance. Errors are reported back to the author instance through the message broker queues. Automatic retries aren’t performed to be more transparent about publication issues.
Feedback

DX Core

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules