Merge Links can help to make the document merge process more flexible. Once you have a Merge Link from a packet you can use it to create links or buttons that can be placed on various pages around Litify. 

Merge Link Setup

Retrieving Merge Link URL

Once you’ve built and saved a packet you will have the option to copy the Merge Link URL. This URL can be used to create buttons or links within Litify to initiate a merge.

Auto-merge_URL_.png

Here is an example of what the URL looks like:

https://docs-psm.lightning.force.com/lightning/n/litify_docs__Direct_Packet_Merge?litify_docs__autoMerge=true&litify_docs__objectApiName=litify_pm__Matter__c&litify_docs__packetIds=a1E6g000000RiTzEAK&litify_docs__recordId={!litify_pm__Matter__c.Id}

Remember:

  • The URL DOES NOT include record ID’s. 
  • Wherever the button or link is placed a record ID will need to be passed in. 

Creating a Merge Button

For this example, the Merge Button will be placed on the top right of the Matter page within the highlight panel.

  1. Click the gear icon and launch the Setup menu. 
  2. Search for and open the Object Manager.
  3. From the Object Manager, select the Object where you would like the button to appear.
    1. For our example we’ve selected Matter.
  4. Click on Buttons, Links, and Actions and click New Button on the page that appears.
  5. Fill out the fields near the top of the page depending on where the button will go and how you want it to behave.
    1. Label: This is what your button will be called.
    2. Name: Should auto-populate based on the Label 
    3. Description: Helpful text to explain what this new button will be used for. 
    4. Display Type: Set based on intended button placement. View the examples to get a better understanding of which option to choose. 
    5. Behavior: The intended behavior of what will happen when the new button is clicked.
    6. Content Source: What is being placed behind the button. For our example, since we retrieved the merge link from within DocGen, our source is a URL.New_Button_-_Top_half_of_page.png
  6. Paste the link you copied from the Template Builder (Merge Link URL) under Automerge for settlement summary (Text).New_Button_-_bottom_half_of_page.png
  7. Add the Salesforce ID conversion function to the link you posted and click Save.

Salesforce uses shorter (15-character) or longer (18 character) IDs depending on the situation. For Merge Links we need to use the longer/18-digit ID. 

When pasting the URL, it's important to use the function for converting the 15-digit salesforce record ID to 18. Otherwise, the merged document will NOT show up correctly on the record. To do this use the {!CASESAFEID(id)} function.

  1. Highlight the ID tag at the end of the URL you posted. 
    1. For example, litify_pm_Matter__c.ID.
  2. Select the Function you want to use in the sidebar. 
    1. For example, CASESAFEID.
  3. Click Insert Selected Function.

Using the example URL above, when that is pasted in and the function is added, this is what it will look like:

https://docs-psm.lightning.force.com/lightning/n/litify_docs__Direct_Packet_Merge?litify_docs__autoMerge=true&litify_docs__objectApiName=litify_pm__Matter__c&litify_docs__packetIds=a1E6g000000RiTzEAK&litify_docs__recordId={!CASESAFEID(litify_pm__Matter__c.Id)}

Updating Page Layout

Once the button has been created, it has to be added to the page layout. 

  1. Go to Setup. Search for App Builder and select Lightning App Builder
  2. Within the Lightning App Builder, locate the page you want to add the Auto-merge button to and click Edit next to it. 
  3. Within the edit view, click into the Highlight Panel.
  4. Check off the box for Enable Dynamic Actions.
    1. This will create an Actions heading right below Enable Dynamic Actions.
  5. Under the Actions heading, click Add Actions. The previously created button for the merge action can be found in this actions list. Search for it, select it, and click Done.
    1. In our example we’ve added the Settlement Summary button.
  6. Once you have added the desired Actions, click Save near the top-right of the page.Page_Layout_-_Add_Actions.png
  7. Navigate to the page where you added the Auto-merge button and confirm that it is there. Clicking the Auto-merge button should initiate an Auto-merge.Matter_-_Automerge_button.png

Configuring Auto-merge Templates

Auto-merge takes the Merge functionality one step further, by enabling merges to be performed without user interaction. One thing to keep in mind, is that Bulk Merges will only work if all templates are set to Auto-merge pull information automatically. 

For any Template you wish to enable Auto-merge:

  1. Locate that template within the Template Builder. unnamed__15_.png
  2. Check the Auto-merge box.
Was this article helpful?
1 out of 1 found this helpful