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

Setting Up Custom Assignee Value Expression Objects

To have values available in the Object picklist when creating a custom value expression for determining assignees, those custom objects must be added to approval system properties. For more details on where these objects are used in Intelligent Approvals, see Creating Expressions.
Note: Custom Salesforce objects are configured as normal.

To set up custom value expression objects

Custom objects to add must already have been created.

  1. Go to Build > Develop > Custom Settings.
  2. Click Manage for Approvals System Properties.
  3. Click Edit for System Properties.
  4. Enter API names for the custom objects you want to use in the UI Custom Assignee Object Types field, separated by commas. The format should be CustomObjectname1__c, CustomObjectname2___c, CustomObjectname3__c.


  5. Click Save when done.
Custom objects are available for selection in the Object picklist in the entry step criteria's Custom Value Expression section, where you select approval request assignees. Toggling the "Free Form?" checkbox enables you to enter a custom formula in the value field.


Custom Assignee Example

You can create custom objects to be used with custom assignee types in approval rules. This example shows how a custom object called GO Approver provides assignees when creating an approval rule.

  1. Create your custom object.
    1. From Setup, go to Create > Objects and click New Custom Object.
    2. Create your custom object, adding the fields needed to create a formula for selecting assignees.
      The API name for the custom object and its fields are used to create the custom formula in the approval rule.


  2. Make the custom object available to Intelligent Approvals via a custom setting.
    1. From Setup, go to Develop > Custom Settings and click Manage for Approvals System Properties.
    2. Click Edit and enter the names of the custom objects you will use with custom assignees in the UI Custom Assignee Object Types field.
      The Approval Systems Property must include the custom object's API name:


  3. Create users for the custom object.
    1. Go to the GO Approver tab to display the page and create all the users you want to approve requests.
      The values you enter in the fields for each user are used when you create formulas for selecting assignees.


  4. Create your approval rules, using formula expressions to select assignees.
    1. Go to a Condition type approval rule and create assignees by selecting Custom User, then entering a formula in the Value field.
      For example, the following formulas route an approval to the indicated assignees based on the users you created for the custom object:

      GO_Approver__c(ProductGroup_Pricing__c='AGRAPH' AND Level_Pricing__c='Level 0').aUser__c

      Jim Borden

      GO_Approver__c(ProductGroup_Pricing__c='AGRAPH' AND Level_Pricing__c='Level 1').aUser__c

      Oscar Borden

      GO_Approver__c(ProductGroup_Pricing__c='BGRAPH' AND Level_Pricing__c='Level 1').aUser__c

      Jane Smith