Publishing flow

In Adobe Experience Platform Launch, the publishing flow refers to the process of creating libraries, testing builds, and approving them for production.

The available actions that you can make on a library depend on the library’s state and the level of permission you have. In addition, a library’s state also affects the resources it contains (rules, data elements, and extensions) depending on what is upstream in the publishing flow.

The sections below cover the details about permissions, library state, and the upstream as they pertain to the publishing flow.

Permissions

There are different levels of user permissions that are important for the publishing flow; specifically, the Develop, Approve, and Publish property rights:

  • Develop: Includes the ability to create libraries, build for development, and submit for approval.
  • Approve: Includes the ability to build for staging and approve staged builds.
  • Publish: Includes the ability to publish an approved library.

These rights are not inclusive. For a single person to perform the workflow from start to finish, that person must be granted all three rights within a given property.

For more information on managing permissions for Platform Launch, see the user permissions guide.

Library state

When it comes to the publishing flow, there are four basic states that a library can be in:

These four states are represented as columns within the Publishing Flow tab in the Platform Launch UI.

Specific actions must be taken to move a library between these states. The following diagram outlines each action that moves a library between states:

Development

When new libraries are created, they start in the Development state. Any changes to a library must be made while the library is in Development. When development and testing are completed, the library can be submitted for approval.

The following table outlines the available actions for a library in the Development state:

Action Description
Edit Use the Edit Library screen to add or remove components from the library.
Build for Development Create a build for the library. The build is compiled and deployed to the environment that the library is assigned to. This step fails if the library has not been assigned to an environment, or contains a change that is already defined in the upstream.
Submit for Approval Unassign the library from the development environment, and move the library to the Submitted column for a user with approval permissions to work on. The last build for the library must be successful in order for this option to be enabled.
Delete Remove the library from Platform Launch. This does not remove the build from the environment.

Submitted

When a library is in the Submitted state, a user with approval permissions can test the library in the staging environment. When testing is completed, the library can be approved or rejected. Rejected builds go back to Development so additional changes can be made before restarting the publishing flow.

The following table outlines the available actions for a library in the Submitted state:

Action Description
Open View the contents of the library. Changes are not allowed for libraries outside of the Development column. If changes are needed, the library should be rejected so changes can be made in Development.
Build for Staging Build the library in the staging environment for deployment.
Approve for Publishing Move the library to the Approved column for a user with publishing permissions to work on.
Reject Unassign the library from the staging environment and move the library back to the Development column for further changes.

Approved

Once a library has been approved, a user with publishing permissions can publish or reject the library. Rejected builds go back to Development so that further changes can be made before the publishing flow begins again.

The following table outlines the available actions for a library in the Approved state:

Action Description
Open View the contents of the library. Changes are not allowed for libraries outside of the Development column. If changes are needed, the library should be rejected so changes can be made in Development.
Build and Publish to Production Unassign the library from the staging environment, assign the library to the production environment, and deploy it.

Important: When this option is selected, your library becomes live in your production environment. Ensure that the library contains the changes you want before you select this option.
Reject Unassign the library from the staging environment and move the library to the Development column for further changes.

Published

Libraries under the Published column are live on the production environment. This column shows which libraries have been published and their publish dates. You can view these libraries, but you cannot make changes to them. If you want to change what is in your production environment, you must create a new library and move it through the complete publishing process.

Upstream

After you have published your first library, it becomes important to understand the role of the upstream as you move newer libraries through the publishing flow.

If a library is currently in the Development, Submitted, or Approved stage, that library will inherit the rules, data elements, and extensions of any libraries that are upstream. These inherited resources constitute a “baseline” for each library as they move through the publishing flow. Essentially, you can think of each new library simply as a series of changes to the baseline that is established by the upstream. This ensures that nothing gets unexpectedly overwritten from a previous library when a new iteration is published.

What is included in the upstream depends on the current stage of the library. For example, libraries in the Approved column only inherit resources from the Published library, whereas libraries under Development inherit resources from all other columns.

When you are editing a library in the Platform Launch UI, all resources that are inherited from the upstream are represented in the Resources Upstream section. To view these resources, select the expand tab below the section heading.

The section expands to show the individual resources that are inherited from the upstream. You can use the left rail to filter between Rules, Data Elements, and Extensions, or use the search bar to look up a specific resource by name.

Next steps

This guide provided a high-level overview of the publishing flow for libraries in Platform Launch. To learn more about how to publish your libraries, refer to the publishing overview.

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now