Step-by-step guide on creating an effective Salesforce deployment checklist for successful releases with Blue Canvas.
This article is here to help you navigate the complexities of handling Salesforce releases! We'll be discussing the limitations of Salesforce Metadata API and the need for manual steps in more intricate deployment scenarios. We'll highlight how dedicated tooling, like checklist integration into deployment stories, can provide superior tracking and coordination. Furthermore, we'll showcase how Markdown can offer a flexible approach to task management, while also enhancing accountability. There really are dedicated solutions to support Salesforce developers in their deployment workflow, and future developments (such as task assignments and enhanced notification systems) will only make it a better experience!
Here are our 5 key takeaways:
Though the Salesforce Metadata API can do wonders, unfortunately there are still manual deployment steps required for most complex Salesforce releases. The API cannot handle everything and in some cases teams don’t want it to. Some changes like Web-to-Lead, Quote Templates, Site.com, Automated Case User Settings are simply not supported in the Salesforce Metadata API. Others like Profiles and Permission Sets are, but still are difficult to automate, diff, compare and deploy.
Accordingly, many of our customers still have fairly sizable checklists of tasks that need to be completed pre- and post- deployment before they can call a release a success.
After watching our users struggle with coordinating these steps, especially in large orgs, we’re excited to announce that you can now create checklists in your Blue Canvas stories for tracking and coordinating the manual steps in your Salsforce release process.
Blue Canvas supports Markdown in the Description field for Stories (i.e. Deployment Requests). Users can leverage Markdown to create custom checklists that can be leveraged to track pre- and post-deployment steps.
But it’s more than just Markdown, Blue Canvas interacts with each checklist on the backend to keep track of the status of a task. As you check off boxes in your Stories, the status of the ticket is updated. You can even mark the manual side of a deployment as “Complete” just as you would in a ticket on any other ALM tool like JIRA.
Take a major release as an example. Blue Canvas allows users to release multiple Stories at once in a coordinated Release. It can be useful to leverage manual checklists to ensure that all the manual steps associated with the release are tracked and understood for accountability and completeness.
First, we can create the release in Blue Canvas. We can then assign manual steps to each member of the team to add their Stories to the release.
When they are done they can check off their box. A release manager now know who has not yet finished pinning their Stories and can reach out accordingly. They can also give status updates to other stakeholders based on the status.
The release can be submitted for validation and testing once the entire chain of manual steps is complete and we know we have a full Release candidate. You can then of course deploy as usual using Blue Canvas and move on to your post-deployment steps.
One great thing about Markdown is that it’s incredibly flexible. We built it this way because we know that teams have different processes for managing manual steps and Markdown offers complete flexibility.
The Description field is really important for Stories. Teams don’t want to just know “what” changed and “who” changed it. They need to document the reasons “why” different parts of a Salesforce system are changed. And the Description field provides teams with a simple and easy way to continuously document their changes as they make them. This spares organizations from having to do annoying and expensive audits every few years.
We’re excited to announce that in addition to this release of pre- and post-deployment step tracking in Blue Canvas, you can generally use Markdown to style and annotate your stories.
You can add headings, checkboxes, columns, links and use font formatting like bold, italics and underlining.
Managing Salesforce deployments, particularly for complex releases, can be a challenging endeavor. As shown in this article, with the innovative features of Blue Canvas this process is made considerably more efficient and manageable. The integration of Markdown checklists into your deployment stories facilitates streamlined tracking, coordination, and documentation of manual steps, enhancing overall accountability and reducing the need for costly audits.
The flexibility offered by Markdown can cater to a range of team processes, while the upcoming enhancements like task assignments and improved notification systems promise to further optimize your deployment task management.
What are the limitations of Salesforce Metadata API?
How does checklist integration help in deployment?
What role does Markdown play in managing deployment steps?
How can regular documentation prevent costly audits?
What are the future developments to expect in deployment task management?
How does Blue Canvas support tracking of manual pre- and post-deployment steps?
How can I use Markdown to style and annotate my stories in Blue Canvas?
How Sysco's team of 40+ developers and admins support a complex Salesforce release flow with Blue Canvas.
Our latest feature offers proactive suggestions so you can avoid dependency errors and better understand relationships between your Salesforce objects.
From your sandbox to a git repository in less than a minute
Why Salesforce DevOps is more than just hooking up a git repo to a Salesforce org
Diving into what it takes to smoothly merge work across Salesforce orgs