Publishing Content to Portal
Once your content is ready for publishing and your deployments are configured in the CCMS, you are ready to publish your content the the portal production environment. Publishing content to portal can be done by users assigned the Administrator role in Heretto CCMS.
Publishing content to your production portal environment means going live, especially for public portals without single sign-on (SSO). For public portals with SSO, published content is only accessible to users with sign-in credentials.
Publishing to portal is possible once:
-
Your content has conditional processing (profiling) applied and DITAVAL filters exist, if applicable
-
Your content is organized into sitemaps
-
Your production branch exists in Heretto CCMS
-
Your deployments are configured in Heretto CCMS
These actions are typically completed by or in cooperation with the Heretto team during the implementation phase. Once all those components are in place, publishing is performed in three simple steps:
Version: Create a release for your main sitemap on the master branch for version control
Preview: Push your content from the master branch to your portal-production branch, then publish your content to your staging portal environment for a final quality check
Publish: Publish your content in the portal-production branch to your production portal environment to go live with that content
If you have content in your main sitemap on the master branch that is not ready to be published, temporarily remove it from the map or filter it out with conditional profiling to make your initial deployment easier. We recommend to only push ready-to-publish (final) content to your portal-production branch.
Publish Content
You publish content to Heretto Portal from the Deployments interface available in Heretto CCMS.
You must have the role of Administrator in Heretto CCMS to complete portions of this procedure.
Publishing content to your production portal environment means going live, especially for public portals without single sign-on (SSO). For public portals with SSO, published content is only accessible to users with sign-in credentials.
-
If you are planning to go live with your production content at this point, verify with your Customer Success Manager that your production portal environment has a custom domain configured.
-
Ensure you are assigned the Administrator role in Heretto CCMS.
In this procedure we assume that these components of the initial configuration have been completed during the implementation phase:
-
Your content has conditional processing (profiling) applied and DITAVAL filters exist, if applicable
-
Your content is organized into sitemaps for Heretto Portal publishing
-
Your production branch exists in Heretto CCMS
-
Your deployments are configured in Heretto CCMS
Ensure your main sitemap contains only ready-to-publish (final) content
Ensure your main sitemap contains no preflight check issues
Create a release for your main sitemap
If the changes you're publishing don't need versioning of the main sitemap, create a release on a lower-level map where the changes apply.
Push the main sitemap from the master branch to the portal-production branch
Publish content to your preview portal environment (Administrators only)
Check the content in your staging portal environment
Publish content to your production portal environment (Administrators only)
Once the publishing process completes, the content in your production branch is published to your production portal. The changes are now visible to anyone who can access your production portal. Congratulations! Your production portal is now live!