How to Build, Manage, and Package Blueprints in Zoho Vertical Solutions: A Complete Guide

Automation - Creating Blueprints

Building a blueprint can be summarized into three main steps:
  1. Specify the basic information: This includes the module, layout, and field for which the process should be created.
  2. Define the process flow: This involves using the Blueprint Editor to create the process flow, starting from the starting state and ending at the exit state.
  3. Configure transition settings: This includes specifying the conditions that must be met before, during, and after a transition between different states in the process.

Step 1 - Enter Basic Information

  1. Log in to Zoho Developer Console and click Vertical Solutions.
  2. Select the application you would like to modify and click Edit.
  3. Click Automate in the left pane menu and select Workflow.
  4. Select the Blueprint tab and click Create Blueprint.
  5. In the Create new Blueprint popup, choose the module, layout and field for which the process is being created.  For our scenario, let us choose a custom module Repairs, Standard layout and the Status field. 
  6. Specify criteria for records to enter a process, if applicable. Example, Membership is Annual. If you don't enter criteria, the records whose field value matches with any of the states used in the blueprint will enter into the process.

Info
Under Advanced Configuration, you can create a continuous Blueprint. A Continuous Blueprint is one that occurs without a pause - ideal for Sales Call Scripting. 
The primary field of the Blueprint can be updated via: 
  1. Transition API
  2. Workflow API 
  3. Custom Functions in Workflows.
You can update the primary field of the Blueprint using only these three ways. 

Step 2 - Define the Process Flow in the Blueprint Editor

  1. In the Blueprint Editor, drag and drop all the States (stages) that form a part of the process.

  2. Establish the process flow between the States by connecting the nodes in the State buttons. Note that the Start State is the equivalent of "None" value of the chosen picklist field.

  3. Create Transitions by clicking on the + button between two States. To delete a transition, simply Right Click on the transition line and click Delete Transition
The white buttons in the Blueprint represent States in the Blueprint (Deal Stages). The green buttons represent Transitions (Conditions required to complete each stage). Each Transition you configure is displayed as a button on the record's details page.
To complete a Transition, click on the Transition button and execute the actions mentioned in the ensuing popup window. On successful completion of the Transition, you will move to the next State in the Blueprint.


For example, clicking on Check warranty will open a pop-up window, which will guide you through executing this transition.

Save a Blueprint as a Draft

Sometimes you may not be ready to deploy your final Blueprint into your Vertical Solution yet, and you may want to put some more thought into the process flow. When you publish a Blueprint, you will begin having records entering it - so it is not a good idea to deploy it before it's ready. In this case, you can save the Blueprint as a DRAFT.



You can work on your States and Transitions in the DRAFT version, and once you are satisfied with the final process flow, you can PUBLISH your draft. Note that the draft version is not a testing environment, rather a canvas of sorts, for you to test your process flow. You cannot test the execution of a Blueprint with the draft version. It is only meant for you to play around with the process flow.
At any given point in time, you can have one Published version and one Draft version of a Blueprint.
Published version: If a Blueprint is published, it means that it is live in your Solution. Records meeting the Blueprint criteria will begin following this version of the process flow.
Draft version: If a Blueprint is saved as a draft, it means that it is not yet deployed in the live Vertical Solution setup, but available for you to experiment, without affecting any existing records. 
When edit a Blueprint, you can either publish the changes directly or save the latest version as a draft. You can toggle between the Draft and Published versions in the Blueprint Editor. 



  1. When you publish your latest changes from the Draft version, if there are existing records already associated with the previous version of the Blueprint, you will be prompted to decide how you want to deal with those records. You can choose between the following options:
    1. Exit Blueprint, that is, take those records out of the process in their last known State.
    2. Move all the existing records to the latest version you are about to publish. This will ensure that all records in a particular module follow a uniform process flow at a given point in time. 
  2. On editing a Blueprint flow, if you have deleted one or more States, when you republish it, you will again be prompted to either move any existing records to the latest version of the Blueprint or move them out of the process. If you choose to move them to the current version, you will be prompted to re-map the deleted States with the ones available in the modified Blueprint flow.  
  3. If you have deleted a Blueprint and you have had active records in it, you will be prompted to move the records out of the process.
  4. In the Blueprints list view page, an asterisk (*) denotes a published Blueprint that also has a draft version associated with it.
  5. A Blueprint that hasn't been published at all and only in drafts, can be identified from its Empty Status (--). In the following screenshot, "After-sales Repair*" is a published Blueprint, that also has a draft version. "Leads Qualification" is a Blueprint only in the Drafts mode.  The Status of a Blueprint conveys whether the process is activated or deactivated. 
  6. If you wish to discard changes made in the Draft version, simply switch to the Published version and click Save as Draft. Now the published version will overwrite your changes in the Draft version and you can start editing again.

Once the you have created the process using States and Transitions, the final step is to define further Transition settings.

Step 3 - Configure Transition Settings

Transition refers to the change of state in a process. It is the connecting link between two States, where the conditions for the change are clearly defined. A Transition is made up of three parts - Before, During and After.
For example, let's look at the Transition between the States - Repair Plan created and Repair Accepted. Let's name this Accept Repair. Following are some guidelines to be observed while configuring the Transition settings in this scenario.
  1. While accepting to take up the repair, it should be ensured that the estimated duration of the repair does not exceed seven days.
  2. As soon as the Accept Repair transition is executed, a call should be made to the mechanic to whom the repair job will be assigned.
Let's see how we can accommodate all of these points in the Blueprint.

Before Transition:

Define Criteria that dictate exactly when this Transition should be available for the records in a process. Example criteria: "Repair plan accepted is True". In this case, the Transition will be shown to records only when the Repair plan accepted? field is updated to True. If you have no such conditions, you can skip the criteria section. In such a case, the Transition will be visible on all records right away. 


During Transition:

This section guides the Transition owners in completing a particular stage in a process by prompting them to enter specific fields, notes, attachments and other information contextually. For example, while accepting a repair, it needs to be ensured that the contact details of the customer have been captured. In such a case, all these details can be mandated in the During Transition section of the Accept Repair Transition.

Following are the details that you can mandate in the During Transition section:
  1. Mandate and validate fields across modules
  2. Include checklists
  3. Mandate Associated Items
  4. Add a message to Transition owners
  5. Make notes mandatory
  6. Make attachments mandatory
1. Mandate and validate fields across modules:
You can guide users to enter information required as part of your process by mandating fields at the appropriate stages. These could be fields from the primary Blueprint module or related modules (using lookup field). For example, during the Accept Repair transition, you can mandate the Customer Name, Phone and Email fields.
To mandate fields of the Blueprint module and related modules:
  1. In the During Transition tab, click Add.
  2. Choose the required module from the drop-down list.
  3. Select the field to be mandated. Repeat this action for the number of fields required. 

  4. Validate fields to ensure that the user enters acceptable values. Here, the estimated duration of repair should not exceed 7 days from the date of accepting the repair. 

2. Include checklists:
Checklists are To-do items to help your users keep a clear track of the number of tasks and items they must complete in order to get through each stage of a process. This helps you better streamline every tiny step that you take towards executing a stage so that you never miss what is important at the moment.
Checklist will be part of your During Transition, which, when configured by the manager or the process architect, will be shown to the eligible transition owners.
For example, in our repair process, the following items could be part of a Repair Plan Checklist assigned to the Create Repair Plan transition.
  1. Abide by the guidelines mentioned in the organization's repair SoP.
  2. Get plan reviewed by supervisor.
To include checklists:
  1. In the During Transition tab, click Add.
  2. Select Checklists.
  3. Add a title for the checklist and the list of To-do items
  4. This will be displayed to the selected Transition owners. Only when the Transition owner "checks off" these items from the list, will he/she be able to proceed to the next State in the Blueprint. This gives you a solid, clear picture of progress of each stage.
3. Mandate the Creation of Associated Items
Apart from fields and checklists, you can mandate the creation of the following items:
  1. Tasks
  2. Events
  3. Calls
  4. Quotes
  5. Sales Orders
  6. Cases
For example, once the repair has been accepted, a task could be assigned to the mechanic who would take up the repair and also a call should be made to the mechanic.
To mandate the creation of associated items:
  1. In the During Transition tab, click Add.
  2. Select Associated Items.
  3. Choose from the Associated Items dropdown list: Tasks and Calls.  


4. Add a message to Transition owners
You can include messages to users at each stage, so that every Transition owner knows what's expected of him/her. 
To add a message to the Transition owners:
  1. In the During Transition tab, click Add.
  2. Select Message.
  3. Write a suitable message in the text box. 


5. Make notes mandatory
You may want to know additional details about various aspects of a process, such as when a user categorizes a repair as Severe, they can add a note detailing the reasons for labelling it so. These additional details could be added as notes - and these notes could also be mandated in the During Transition stage of a process.
To make notes mandatory, in the During Transition tab, select the Make Notes as Mandatory checkbox.  While executing the Severe transition, the transition owner will be required to enter details of the repair as notes, as outlined in the message.


6. Make attachments mandatory
Any process, be it sales, insurance, manufacturing or real estate - any business process for that matter brings with it the need for several documents. Sales contracts, Service Level Agreements, Legal Documents and so on are required at different stages of a process. You can mandate them at the required stage in a Blueprint.
To make attachments mandatory:
In the During Transition tab, check the Make Attachment as Mandatory checkbox.  While executing the Severe transition, the transition owner will be required to attach the documents that support the reasons for categorizing a repair as Severe. You can reorder the items to be displayed in the popup window by using the UP and DOWN arrows. 

7. Make Tags Mandatory
As part of the During Transition settings, you can also mandate tags to be entered.
When a user performs this transition, they will be prompted to enter a value for tags, as part of the Blueprint. 


8. Add Widgets
You can also mandate widgets as part of the During Transition settings in Blueprint.  


By mandating a widget, you can define your own parameters that need to be entered as part of the process. 

After Transition:

Define actions to be automated at the completion of the Transition. Actions that can be automated in the After Transition section are:
  1. Send Email Notification
  2. Assign Tasks
  3. Make a Field Update
  4. Trigger Webhooks
  5. Trigger Custom Functions
  6. Convert Record (Applicable for the Leads and Quotes modules) 
In our example, a task should be created so that the bill is generated after the Complete Repair transition. So, choose Tasks and add the necessary conditions. 

Similarly, you can build conditions for each Transition until the end of the process.

Common Transition

A Common Transition is a Transition that can be executed from all States in a process. 
For example, in a Deal follow-up process, you typically know if you have won or lost a deal after the record goes through several stages such as qualification, negotiation, discount approval and so on. So Deal Lost is a Transition that is available only towards the end of the process. But assume that a customer shows no interest and you want to drop a deal at the Qualification stage itself. In such a case, you must be able to execute the Deal Lost Transition right then - rather than go through all the intermediary stages. 
To make this possible, you must make Deal Lost  a Common Transition by selecting the checkbox as seen in the following image. Once you do, you will see the Deal Lost transition on all States. 



Automatic transitions

Info
Automatic Transitions are available in Vertical Solutions in early access mode.
Automatic transitions help you combat process delays. Often, a record that traverses through a process tends to stagnate in a particular state and you may not even realise it. This causes unwarranted delays. One thing you can certainly do is set an SLA for the state and be notified whenever there's an escalation.
But ultimately, SLA is also a notification or a task/field update of sorts— the record at the end of the day, needs your manual intervention in order to progress further in the process. If you only want to be notified of escalations, you may configure SLAs. On the other hand, if you want the system to act and automatically move a record from one state to another at any point, you can now create automatic transitions.

What are automatic transitions and how do they work?
An automatic transition is one in which a record in a Blueprint automatically moves from one state to another, after a specified "Wait" time has elapsed.
As per the process, in order for a record to go from State A to State B, you will have to perform a Transition A. If this Transition A has not been executed within a said time period, say, 5 days, then the Automatic Transition configured for that state will get executed and the record will be pushed forward automatically to another state in the Blueprint as per the configuration.
For instance, in the following screenshot, the system will wait for one of the transitions to take place: Either "Confirm Interest" or "Drop deal". If no action is taken on this record until a said date, the record will be moved to the "Price Quote" stage automatically and the users can take it up from there.


To configure an automatic transition:
Select the Automatic Transition checkbox as you create a regular transition.


Same-state looping

A process often contains steps which you have to attempt multiple times for it to be successful. A typical example would be an attempt to contact a customer. In order to gather their requirements you will have to call them. But often they may be unavailable or may ask you to call later. Unless you speak to them, you cannot go to the next stage, so you have to stay in the same state until they answer. However, your staying in the same state doesn't also mean you did not do your job — you just have to try multiple times until you are successful.
In such cases, you can now create a transition that "loops back" to the same stage. The From and To state is the same. For example, in the following deal follow-up process, you can use the "Retry contacting" transition infinite number of times, until you are successful in which case you will select Customer Available and progress further.


Configure SLAs for States 

When you put a process in place in your organization, you need to ensure that it also gets done on time. SLAs help you do exactly that. "SLA" stands for Service Level Agreement - and is usually understood in the context of a service provider and customer. This term in Blueprint stands for an agreement of sorts between teams within an organization to communicate the maximum time a sales rep/team can keep a particular record in a said state. For example, if a deal is the "Qualification" stage for too long, the sales manager or the record owner must be notified of this. But how long is too long? If it does stay in a State for too long, who should be notified and what should be done about it? These details can be configured as part of the Blueprint via SLAs. When you configure an SLA, the system watches the records and how long each record is in a particular state. If it exceeds the time limit mentioned, the system will send alerts as configured to the users mentioned in the SLA settings. This helps you be transparent with the progress of a process across your organization and get things done on time. 

To configure SLA for a State :
  1. In your Blueprint Editor, click the State for which you wish to configure the SLA. Example, Negotiation/Review.                   
  2. Set the maximum time limit for which the deal can be in the Negotiation State. Example, 5 Days. 
  3. When the deal exceeds the SLA time limit, specify who should be notified and when.  Example, escalate on the 5th day to the record owner. 
  4. In addition to this standard notification ON escalation, you can set an additional alert to be sent before or after the SLA time limit. For example, notify the record owner about the SLA time limit two hours before the limit expires.


This will help you take prompt action before it's too late. You can also select further user-defined SLA actions to be automated apart from the standard alerts.
These user-defined SLA actions include custom email notifications, tasks, field updates, webhooks and custom actions. 
For example, let's say that as per your process, you want to be alerted whenever a record has stayed in the Negotiation State for more than 5 days. For this, apart from the default email alert you can choose to automate a field update where a field called "Urgency" gets updated from "Mild" to "Severe" whenever a record has stayed in the Negotiation state for more than 5 days. Later you can filter out records for which the urgency is severe and prioritise their transitions first.

Notes
  1. Blueprints will be executed in the order in which they are listed in the Blueprint page. You may reorder the processes if required.
  2. When you have all automation features configured in Vertical Solution, the order in which they get executed are: Assignment rules, workflow rules, approval process, Blueprint and finally case escalation rules.
  3. Different users can own different Transitions in a process. If a user does not have access to a record but is made a Transition owner, then the user will be able to execute the Transition but not edit the record.
  4. There can be up to 20 outcomes from a State. That is, one state can be connected to 20 different States through different transitions.
  5. If you modify* a Blueprint while there are still active records in the process, you will be prompted to either move those records to the latest version of the Blueprint or exit them out of the process altogether. (*) Modification here refers to:
    1. A change in the process flow
    2. Deactivation of a Blueprint
    3. Deletion of a Blueprint
  6. Note that modification does not refer to changes made to the Transitions. Any change made to the Transition blocks in a Blueprint is effective immediately, regardless of new records or existing records in the process.
  7. You cannot delete a Blueprint while there are active records in the process. However, you can deactivate it so that further records do not enter the process.
  8. Blueprint overrides the field access rights set for a user. For example, if a user has Read-only access to the Amount field, but is responsible to execute a Transition that mandates the Amount field, he/she will be able to update the amount while executing the Blueprint Transition. At all other times, the user will continue to have Read-only access to the field.
  9. A Transition will be visible only to the chosen Transition owner(s) and users on the Administrator profile. A Transition owner can access records assigned to him/her from the My Jobs module.

Packaged Blueprints

Packaged Blueprints are blueprints that are created in the console by a developer and deployed to the subscriber orgs during signup or through upgrade. The following content explains how these blueprints behave in subscriber orgs. 
Info
Tip: To know more about packaging, please refer to our help guide : Components Packaging in Vertical Solutions Platform.
Notes
Only published Blueprints are available for packaging. The changes that are not published will not be available for packaging.
The table outlines the behaviour of packaged Workflows.
Property
Upgrade-Type
Modify Access
Name
Upgradable
Developer Editable
Status
Non-Upgradable
Developer and Subscriber Editable
Blueprints order
Non-Upgradable
Developer and Subscriber Editable

Changes and Impacts  

When a packaged Blueprint is modified, published, and pushed as an upgrade to the subscribers' accounts, the impacts to the existing records in their orgs, such as leads, contacts, etc, are as follows:

  1. Add a new Blueprint: The new blueprint will be effective only based on it's state (active/inactive).  It will apply to records created or modified after the upgrade, based on the blueprint’s state (active/inactive).
  2. Modify a Blueprint: Updates to a blueprint will impact only records created or modified after the upgrade.  The Records that are associated with the modified blueprint at that instant will either remain in, or move to the current version of Blueprint.
    1. Add a New State: If a record is in State A, and the previous version of the blueprint had State B as the next step, but a new State C is introduced between A and B, the record will transition to State C (reflecting the updated version).
    2. Edit a State: Any changes made in the developer console will be reflected in the subscriber’s org. Records will automatically move to the latest version of the blueprint.
    3. Delete a State: If a record is in State A and that state is deleted with no available transitions, the record will remain under the blueprint's process, but its primary field will become uneditable. The record will not exit the blueprint.
    4. Transitions: All changes made to the blueprint’s transitions in the developer console will be reflected in the subscriber’s organization. Records will follow the updated transition rules based on the current version of the blueprint.
  3. Delete a Blueprint: The Blueprint will be removed from the subscriber account and all the associated records will be dis-associated from it.



    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION





                          Quick Links Workflow Automation Data Collection
                          Web Forms Enterprise Begin Data Collection
                          Interactive Forms Workplace Data Collection App
                          CRM Forms Customer Service Accessible Forms
                          Digital Forms Marketing Forms for Small Business
                          HTML Forms Education Forms for Enterprise
                          Contact Forms E-commerce Forms for any business
                          Lead Generation Forms Healthcare Forms for Startups
                          Wordpress Forms Customer onboarding Order Forms for Small Business
                          No Code Forms Construction RSVP tool for holidays
                          Free Forms Travel
                          Prefill Forms Non-Profit

                          Intake Forms Legal
                          Mobile App
                          Form Designer HR
                          Mobile Forms
                          Card Forms Food Offline Forms
                          Assign Forms Photography
                          Mobile Forms Features
                          Translate Forms Real Estate Kiosk in Mobile Forms
                          Electronic Forms

                          Notification Emails for Forms Alternatives Security & Compliance
                          Holiday Forms Google Forms alternative  GDPR
                          Form to PDF Jotform alternative HIPAA Forms
                          Email Forms
                          Encrypted Forms
                          Embeddable Forms
                          Secure Forms
                          Drag and Drop form builder
                          WCAG


                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Blueprints in Vertical Solutions - An Overview

                                                                                                                Businesses often have complex multi-stage and multi-step sales processes. These processes can be challenging to manage and track, particularly so if they are not well-defined or documented. This might result in inconsistencies and gaps in the ...
                                                                                                              • Parallel and Multiple Transitions in Blueprints in Vertical Solutions

                                                                                                                This feature is currently in early access mode and will be rolled out to all users in the first week of November 2024. Parallel Transitions in Blueprints In a blueprint, each stage or milestone is defined as a State, and the movement between these ...
                                                                                                              • Automation - Workflow Field Updates

                                                                                                                Field Update helps you automatically update certain field values in the records, when the associated workflow rule is triggered. To create field updates Log in to Zoho Developer console and click Vertical Solutions. In the Vertical CRM page, select ...
                                                                                                              • Automation - Setting Up Webhooks

                                                                                                                This guide will help you with the following: Set up Webhooks Use Webhooks Business Scenario 1- Calculate Sales commissions in Zoho Creator App Refer Error Codes HTTP Status Codes Custom Errors Webhooks facilitates communication with third-party ...
                                                                                                              • Automation - Workflow Rules

                                                                                                                This guide will help you with the following: Create Workflow Rules Part 1 - Specify the basic details of the rule  Part 2 - Configure the execution criteria  Part 3 - Set the rule criteria  Part 4 - Associate instant and/or time based actions ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources