Developing Resource Statuses in AEM Sites

Adobe Experience Manager's Resource Status API's, is a pluggable framework for exposing status messaging in AEM's various editor Web UIs.

The Resource Status for Editors framework provides server-side and client-side APIs for displaying and interacting with editor statuses, in a standard and uniform manner.

The editor status bars are natively available in the Page, Experience Fragment and Template editors of AEM.

Example use cases for custom Resource Status Providers are:

Notifying authors when a page is within 2 hours of scheduled activation
Notifying authors that a page was activated within the past 15 mins
Notifying authors that a page was edited within the last 5 mins, and by whom

AEM editor resource status application architecture

When developing custom Resource Statuses, the develop work is comprised of:

The ResourceStatusProvider implementation, that is responsible for determining if a status is required, and the basic information about the status: title, message, priority, variant, icon, and available actions.
Optionally, GraniteUI JavaScript that implements the functionality of any available actions.

sample-editor-resource-status-application-architecture

The status resource provided as part of the Page, Experience Fragment and Template editors is given a type via the resources "statusType" property.

Status types by editor:

Page editor: editor
Experience Fragment editor: editor
Template editor: template-editor

The status resource's statusType is matched to registered CompositeStatusType OSGi configured name property.

For all matches, the CompositeStatusType's types are collected, and used to collect the ResourceStatusProvider implementations that have this type, via ResourceStatusProvider.getType().

The matching ResourceStatusProvider is passed the resource in the editor, and determines if the resource has status to be displayed. If status is needed, this implementation is responsible for building 0 or many ResourceStatuses to return, each representing a status to display.

Typically, a ResourceStatusProvider returns 0 or 1 ResourceStatus per resource.

ResourceStatus is an inteface that can be implemented by the customer, or the helpful com.day.cq.wcm.commons.status.EditorResourceStatus.Builder can be used to construct a status. A status is comprised of:

Title
Message
Icon
Variant
Priority
Actions
Data

Optionally, if Actions are provided for the ResourceStatus object, supporting clientlibs are required to bind functionality to the action links int he status bar.

(function(jQuery, document) {
    'use strict';

    $(document).on('click', '.editor-StatusBar-action[data-status-action-id="do-something"]', function () {
        // Do something on the click of the resource status action
      
    });
})(jQuery, document);

Any supporting JavaScript or CSS to support the actions, must be proxied through each editor's respective client libraries to ensure the front-end code is available in the editor.

Page editor category: cq.authoring.editor.sites.page
Experience Fragment editor category: cq.authoring.editor.sites.page
Template editor category: cq.authoring.editor.sites.template

Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices | Online Privacy Policy

Developing Resource Statuses in AEM Sites

Overview

Resource status provider framework

View the code

Supporting materials

Ask the Community

Contact Us

Overview

Resource status provider framework

View the code

Supporting materials

More like this