Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Show Page Sections

download

Rule-Based Approval Flow

The Rule-Based Approval Flow uses predefined business rules and entry criteria to automatically determine when to initiate an approval flow and identify the appropriate approvers. It is ideal for standard, repeatable approval scenarios that require consistency and automation.

Approval steps assign approval requests to various users and define the chain of approval for a particular approval rule. Each approval step specifies the attributes a record must have to advance to that approval step, the user who can approve requests for those records, and whether to allow backup assignees of the approver to approve the requests. Regardless of their complexity, when anyone in the process rejects an item, the entire process is considered rejected.

This topic explains how to create a new rule-based approval flow, define conditions for the rule, set up auto re-approval, configure reminders and escalations, and delete a flow.

Creating a Rule-Based Approval Flow

  1. Log in to the Conga Advantage Platform as an admin.
  2. Click the App Launcher () icon in the top-left corner, then go to Shared Apps > Approvals. If the Approval Flows window does not open by default, click Approval Flows from the left-side menu to open it.
  3. Click the Create New button.
  4. In the New Approval dialog box, enter the process name, the object type (what sort of thing is being approved), and a brief description of the new approval flow. Keep the Is Adhoc toggle disabled to create a rule-based approval flow. To learn more about ad hoc flows, see Ad Hoc Approval Flow.


  5. Click Create, opening the Approval Flows window to the Setup tab.
  6. An approval process consists of at least one step, with a person or procedure deciding whether and where the next step, if any, will occur. For each step, click the step box in the Setup window or the plus button in the appropriate location in the Approval Flows Setup window.
  7. For each step:
    1. You must name the step: enter a step name in the Step Name field.
    2. You may describe the step: enter a brief description in the Step Description field.
    3. You must define the step type: select whether the step is a standard step, a child process, or a sub-process by selecting from the Step Type pull-down menu. When you do this, additional options will appear based on the step type you have selected.
      1. Selecting the Standard step type raises the required Assignee Type and Assignee fields, and the optional Assignee Description field. You can assign to a user, custom user, related user, or queue. Selecting the Standard step type also offers toggles for: Step Auto Complete, Send Email, Notify Only, Skip Unresolved Assignee, and Step-Level Comments. See Standard-Step Options.
      2. Selecting the Child Process step type raises the required Context Object and Approver Rule fields. See Child Process Step Options.
      3. Selecting the Sub Process step type raises the required Approver Rule field. See Sub-Process-Step Options.
    4. Flip the Step-Level Comments toggle to allow reviewers to add comments when interacting with this step in the approval flow. Click Configure Comments link to choose the step-level comment labels that will appear to the reviewer at runtime. When the entry criteria for this approval process are met—such as when someone submits a record for approval—reviewers can add submission comments at the step level. For more details on enabling this option and defining step-level comment labels, see the Comments section in the Approval Flow Settings.
    5. You can search user names in the Carbon Copy (cc) field to nominate notification recipients.
    6. You can shape the flow using the Step Dependencies field to select a dependency that must be fulfilled before a given step can occur. A step dependency is a step that must be completed before the present (dependent) step becomes active. If a flow is established without dependencies, all flow steps occur simultaneously. Using this logic, you can give two different steps a common dependency to make them occur at the same stage (parallel processes) in a flow.
    7. Click Add Display Header Fields to configure Display Header Fields:
      1. Select up to three fields to display on the left pane of the My Approvals page for this step.
      2. After selecting the fields, click the Add button.
      3. Click Insert to apply the selected fields.
      Note: The Left Panel of the My Approvals page displays a maximum of three header fields. This applies to all Standard, Sub-process, and Child Process steps. If no fields are configured, the Left Panel header remains blank.
    8. Click Add Display Fields to configure Dispplay Fields:
      1. Select up to six fields to display on the right pane for the approval step.
      2. After selecting the fields, click the Add button.
      3. Click Insert to apply the selected fields.
  8. When you have completed the flow, click Save.
A rule-based approval flow is created in an inactive state and appears in the Approval Flows list.
You can configure entry criteria, email templates, comment settings, and actions for each stage. You can also streamline the process with options like consolidated notifications, post-rejection approvals, and backup admin assignment. For more details, see the Approval Flow Settings. Once configured, activate the flow from the Approval Flows list.

Standard-Step Options

Standard step types have a single approver and cannot use rules.

When you select the standard step type in step 5. c. above, you receive choices in the Assignee Type pull-down for the User, Custom User, Related User, Queue, and Custom Queue assignee types.

Type

Description

Associated Fields

User

Assigns the approval request step directly to a user. No logic is employed to discriminate in the assignment. The user identity is fixed and, barring delegation or reassignment, unchanging.

Assignee (required): Username of the assignee responsible for the approval request

Assignee Description (optional): Description of the assignee (in this case, an individual, e.g. "Vice President, Sales")

User Role

A User Role determines a user's access to objects, records, and actions they can perform. Roles are assigned to users with similar tasks and come with a set of predefined permissions. Any user with the assigned role can take ownership of an approval request and approve or reject it. The assignment is not based on any logic to prioritize users, and the assigned user remains fixed unless delegated or reassigned. To learn more about creating a role, see Creating Roles.

Assignee (required): This search option allows you to perform a keyword search and select a predefined user role consisting of one or more reviewers.

Assignee Description (optional): Description of the assignee (in this case, a role, e.g. "Manager").

For example, If a role like "Manager" is selected, any user with the "Manager" role will automatically be included as an assignee. If additional users are assigned the same role in the future, they will automatically become part of the approval process without needing manual updates.

Custom User

A custom user is a user (or users) selected by reference to logic from a custom object. Custom objects, defined in the Conga Platform, are tables that in this instance link a set of logical tests to a named user or set of users. Each row contains one or more conditions (criteria) and an approver.

Object (required): Pull-down menu for selecting the object associated with the custom user expression. This set of object is defined from the Approval Custom Configurations.

Record Criteria: When you choose an object, a set of definitions, corresponding to table columns in the custom object, becomes available. Click the Add Criteria hypertext below the Record Criteria field to access the Record Criteria popup. This enables you to enter one or more criteria consisting of Field, Operator, and Value. These can be read as if–then statements. When you are done, the resultant expression is stored in the Record Criteria field.

Assignee (required): When the criteria are satisfied, the assignment is sent to the user(s) designated in the custom user defined in the designated custom object field.

Assignee Description (optional): Description of the assignee (in this case, an individual, e.g. "Vice President, Sales")

Related User

A related user is a user found by reference to a user lookup reference field in the associated business object (e.g., Agreement or Opportunity). This enables you to assign a user associated with the business object (or record) as the approver. For example, you can assign an account's executive sponsor as an approver of that account's quotes. By specifying the executive sponsor via a user field on the account record associated with the quote, you can create a rule or flow where the assignee is held in the executive sponsor field on the account object.

Assignee (required): This field is populated with a related-user definition when you click Add Assignee as described in Adding a related user to a flow.

Assignee Description (optional): Description of the assignee (in this case, an individual, e.g. "Vice President, Sales")

Queue

A queue is a defined group of approvers, any of whom can take ownership of the requested approval and approve or reject it. No logic is employed to discriminate in the assignment. The user identity is fixed and, barring delegation or reassignment, unchanging. To learn more about creating a user group, see Creating User Groups.

Assignee (required): This pull-down menu enables you to select a predefined queue or user group consisting of one or more reviewers.

Assignee Description (optional): Description of the assignee (in this case, a queue, e.g. "Contract Review Committee")

The system sends an email to all members if the IsSendEmailToMembers property on the user group is enabled. For more details, see Create a User Group API.

If the IsSendEmailToMembers property is disabled, the email is sent only to the email address associated with the user group, provided it is not suppressed by Approval System Properties. However, in this case, the system does not process any responses received from the email.

For example, If any member of the Contract Review Committee can approve a transaction, the "CRC" queue is set as the transaction's required reviewer. All committee members receive notification. The matter is resolved when any member of the committee authorizes or rejects the transaction.

Custom Queue

A custom queue is a queue nominated by business logic from a custom object table.

Object (required): Pull-down menu for selecting the object associated with the custom queue expression. This set of object is defined from the Approval Custom Configurations.

Record Criteria: When you choose an object, a set of definitions, corresponding to table columns in the custom object, becomes available. Click the Add Criteria hypertext below the Record Criteria field to access the Record Criteria popup. This enables you to enter one or more criteria consisting of Field, Operator, and Value. These can be read as if–then statements.

Assignee (required): This pull-down menu enables you to select a predefined queue consisting of one or more reviewers, any of whom can review for the entire group individually. For example, if any member of the Contract Review Committee can approve a transaction, the "CRC" queue is set as the transaction's required reviewer. All committee members receive notification. The matter is resolved when any member of the committee authorizes or rejects the transaction.

Assignee Description (optional): Description of the assignee (in this case, a queue, e.g. "Contract Review Committee")

Selecting the standard step type in step 5. c. also raises these options:

  • Step Auto Complete: Fill in values for the user when the authorization or review is presented to them.
  • Send Email: Notify reviewer of an approval step with a call to action.
  • Notify Only: Notify recipient of approval step with no call to action.
  • Skip Unresolved Assignee: Allow the approval flow to continue when an assignee cannot be reached.

Child Process-Step Options

Before you can configure a child process, a pre-configured rule must be available for inclusion.

When you select the Child Process step type in step 5. c. above, these options appear:

Context Object. You must choose one of the following from the Context Object pull-down menu:

  • Contract: The step pertains to a contract.
  • Contract Clause: The step pertains to a contract clause.
  • Clause Approval: The step requires a contract clause to be approved.

Approver Rule. You must assign one approver rule. Enter the name of the rule you will apply here. Rule name auto-completion begins when you enter three characters.

Sub-Process-Step Options

Sub-processes require a pre-configured rule to be available for inclusion before you can configure them.

Approver Rule. You must assign one approver rule. Enter the name of the rule you will apply here. Rule name auto-completion begins when you enter three characters.

Adding a Related User to a Flow

Adding related users enables you to configure flows to send items for approval to users or properties identified dynamically, rather than by pre-configuration.

  1. Follow the steps in Creating a Rule-Based approval flow to open the Rule entries tab.
  2. Click the Setup tab to open the Approval Flows Setup window.
  3. Click a step entry or one of the plus-sign icons to edit a step, add to an existing step, or add a new step.
  4. Label, sequence, and describe the rule entry step as needed.
  5. Select Related User in the Approver Type field. This raises the Add Approver hyperlink below the Approver field.
  6. Click the Add Approver hypertext to raise an attribute selector. This selector reflects the business object type (Opportunity, Contract, Proposal, Product Configuration, Line Item, Contract Clause, Contract Line Item) chosen in the Approval Flows window for this approval flow.
  7. Select the parameters that result in the related-user identity you want the flow to identify. For example, to select an account owner by ID to approve a contract type, select Account, Owner, and Id:


    This selection is reflected in the bottom legend: "You have selected Account.Owner.Id".

  8. Click Insert. The string entry is added as a related user.


    This string is added to requests to the CLM backend to identify documents' account owners dynamically and to route them for approval without laborious fixed definitions.

  9. Complete the flow entry definition as described in Creating a Rule-Based approval flow.

Configuring Custom Users and Queues

Custom users and custom queues are objects defined on the Advantage Platform. They represent a user or group of users with tabular characteristics in the underlying platform logic. In the Approvals context, they provide the opportunity to present a highly granular definition of the required recipient. For example, one could configure an object that contains a detailed roster of representatives identified by ZIP code ranges, such that a regional representative can be solicited for an approval based on the sales region in which a service will be provided.

To configure a custom user or custom queue, follow the procedure in Creating a New Custom Object.

Customizing an Approval Flow

  1. Find an approval flow from the Approval Flows window and click the More () icon.
  2. Select Edit from the pull-down menu, raising the Setup window.
  3. You can edit, add, or delete individual steps in a flow. The steps appear on the screen in entry order until you set dependencies.
  4. Add steps as described in step 5 of Creating a Rule-Based Approval Flow.
  5. When a step has been saved and is written to the Approval Flows Setup window, you can further customize it by clicking the More (kebab) menu and selecting from the pull-down menu:


    • Add Condition: This applies conditional logic to a step. For example, require this step if permission if an opportunity exceeds a certain threshold; else skip to next step.
    • Auto Reapproval: If the assigned reviewer has approved this step once at the present value, their reapproval is assumed and the approval continues. For example, if a sales rep has approved a 50% discount in the past, their approval of a 40% discount on reapproval can be assumed for the current reapproval cycle.
    • Reminder Setup: This sets an email reminder at a given point in the approval cycle.
    • Escalation Setup: Sets an escalation path and timing. For example, if a sales manager fails to approve a deal after 5 days, escalate to the VP of Sales.
    • Delete: This deletes the step only.
      Note:

      If all steps are deleted, the approval flow resets from Active to Draft status.

Deleting an Approval Flow

  1. Find an approval flow from the Approval Flows window and click the More (kebab) icon.
  2. Select Delete from the pull-down menu.
  3. Click Delete from the confirmation popup.