Quark Publishing Platform v5.x Migration Guide

Migration of QPP from v5.5.0 to v5.6.0

Snapshot and Artifactory Upgrades

Include the snapshot version 5.6.0 or replace version 5.5.0 with 5.6.0 –

          <dependency> 
                    <groupId>com.quark.qcep.contentservices</groupId> 
                    <artifactId>qcep-contentservices-remoting-stubs</artifactId> 
                    <version>5.6.0</version> 
          </dependency> 
          <dependency> 
                    <groupId>com.quark.qcep.automation</groupId> 
                    <artifactId>qcep-automation-interface</artifactId> 
                    <version>5.6.0</version> 
          </dependency>

Include web component artifacts' version 5.6.0 or replace version 5.5.0 with 5.6.0 –

          "@quark/application-services-model": "5.6.0"
          "@quark/platform-components-ng": "5.6.0"
          "@quark/qwc": "5.6.0"

Web Components and Services

The following changes have been made to the web components, services, and modules in the upgrade from v5.5.0 to v5.6.0. 

Web Components

List of modified components
  • qpp-attribute-list-ui.component: QppAttributeListUIComponent 

  • qpp-multi-files-asset-form.component: QppMultiFilesAssetFormComponent

  • qpp-bulk-actions.component: QppBulkActionsComponent

  • qpp-automation-channels.component: QppAutomationChannelsComponent 

  • qpp-background-tasks.component: QppBackgroundTasksComponent

  • qpp-asset-form.component: QppAssetFormComponent

  • qpp-asset-workflow: QPPAssetWorkflow 

  • qpp-collection-properties: QppCollectionProperties 

  • qpp-query-builder: QppQueryBuilder

  • qpp-query-params-dialog: QppQueryParamsDialog

  • error-reporting.component: ErrorReportingComponent 

  • qpp-meta-attribute.component: QppMetaAttributeComponent 

  • qpp-translation-attributes.component: QppTranslationAttributesComponent

  • qpp-workflow-list.component: QppWorkflowListComponent

Services

List of newly added service
  • extended-time-pipe.service: ExtendedTimePipeService

Modules

List of newly added module
  • qpp-shared.module: QppSharedModule

List of modified modules
  • attribute-component.module: AttributeComponentModule 

  • automation-channel-component.module: AutomationChannelComponentModule

  • background-tasks.module: BackgroundTasksModule 

  • collection-components.module: CollectionComponentsModule 

  • error.module: ErrorModule 

  • meta-components.module: MetaComponentsModule 

  • translation-component.module: TranslationComponentModule 

  • user-components.module: UserComponentsModule

  • workflows.module: WorkflowsModule

List of modified application service models

  • import-export-response: ImportExportResponse

Other modified classes

  • qpp-multi-file-attribute-display: QppMultiFileAttributeDisplay 

  • qpp-meta-info: QppMetaInfo 

  • attribute-form-utility: AttributeFormUtility

  • utility: Utility 

  • qpp-moment: QppMoment

List of modified QWC service

  • time-pipe.service: TimePipeService

List of other modified QWC class

  • time-since-pipe: TimeSincePipe

APIs

In the v5.6.0 release, no new APIs have been introduced, and there are no changes to the existing APIs. The focus of this release is on resolving bugs within the current API set. 

Breakage/Impact

Manual Action Required: Re-index Specific Content Types

Following the upgrade to v5.6, any assets using custom date formats that were previously impacted by indexing failures will require a manual text index regeneration. Until this process is complete, these assets may not appear correctly in search results. 

Configuration Details/Setup Requirement

Adding Date Formatting Support to application-config.json

Starting with v5.6, QPP intelligently adapts date formats to match each user's local system settings. Upon migration, your global teams will automatically see dates in their familiar regional formats (e.g., MM/DD/YYYY vs. DD/MM/YYYY) without any manual configuration. 

Customization & Standardized Formats

While the system defaults to local settings, you can still enforce a specific global format if your business use case requires it. This is handled through two new properties in the application-config.json: 

  • dateFormat: Set a specific pattern (e.g., YYYY-MM-DD) to override local settings. 

  • dateTimeSeparator: Define a custom character to separate date and time strings. 

For detailed technical instructions on how to edit the configuration file and a list of supported format strings, please refer to the Dev Portal documentation. 

Licensing and Privileges Update

  • No new privileges have been introduced in v5.6.0. 

  • No changes have been made to any existing privileges in v5.6.0.