Enabling versioning in Swift publication

DX Core publishing versions pages by default in the publishing process. To enable versioning for content within the Assets app and other content applications when using Swift publication, each respective application needs configuration.

Configuring content apps

To configure content applications for versioning with Swift publication, follow the steps illustrated using the Personas app below.

Decorate versions.yaml: Update this dialog definition to use version configurations from the swift-versioning-ui module.

personalization-personas-app/dialogs/versions.yaml

form:
  properties:
    versions:
      datasource:
        name: s3-version

actions:
  commit:
    class: info.magnolia.swift.versioning.ui.action.ShowSwiftVersionActionDefinition

Decorate publishing actions: Ensure all publishing, deletion, and restore actions use the external catalog.

personalization-personas-app/apps/personas-app.yaml

...
      activate:
        catalog: external (1)
        $type: jcrCommandAction
        command: publish
        icon: icon-publish
        availability:
          writePermissionRequired: true
          rules:
            IsNotDeletedRule: *IsNotDeletedRule
...

1	Changed from the default `versioned`.

Configuring the DAM app

The DAM app’s versioning configuration for Swift publication mirrors that of other content apps. You should decorate publishing, deletion, and restore actions for Swift publication.

The catalog property must be set to external.
The bulk property isn’t supported and must be set to false.

/dam-app-jcr/decorations/dam-assets-app/apps/dam.subApps.yaml

    publish:
      icon: icon-publish
      class: info.magnolia.ui.contentapp.action.JcrCommandActionDefinition
      command: publish
      catalog: external (1)
      bulk: false (2)
      availability:
        multiple: true
        writePermissionRequired: true
        rules:
          notDeleted: *notDeleted
          isPublishable: &isPublishable
            $type: jcrPublishableRule

1	The `catalog` property is set to `external` for Swift publication.
2	The `bulk` property is set to `false` because it isn’t supported in Swift publication.

Feedback

DX Core

Enabling versioning in Swift publication

Configuring content apps

Configuring the DAM app

Location

Main doc sections