How to call DocMerge from a Hook ?

Question

Hi guys, 
 
 does one of you already try to call DocMerge from a Hook (or similar code context) ? 
 Of course I know it can be done through BPM ; but what we want to do can be trigger and handle using BPM. 
 Also, I would like to see if error handling is better with code generation. 
 
 Best regards, 
 Fred

Frédéric Rinaldi · Answer

Hi Frédéric Rinaldi , 
 Here is some ideas we came up with: 
 You can create the hook and call the merge function from the DocumentMergeApi. Just instantiate the class and call the function. The function should receive the proper arguments. They can be identified from the code inside the function

$data = [
 'mergeType' => $request->getValidInputPost('mergeType'),
 'useRevision' => $request->getValidInputPost('useRevision') ?? true,
 'templateName' => $request->getValidInputPost('templateName'),
 'templateId' => $request->getValidInputPost('templateId', 'Assert\Guid'),
 'recordId' => $request->getValidInputPost('recordId', 'Assert\Guid'),
 'recordModule' => $request->getValidInputPost('recordModule'),
 'parentId' => $request->getValidInputPost('parentId'),
 'parentModule' => $request->getValidInputPost('parentModule'),
 'maxRelate' => $request->getValidInputPost('maxRelate') ?? static::MAX_RETRIEVE,
 ]; 
 Also you'd need to create for each merge, a DocumentMerge record. This actually tracks the merge status. Once you call the merge function they will immediately get a response from the server. The response is the merge request id. After that, the server will update the DocumentMerge record that was created earlier, with the status messages, like Retrieving data , Document Generated or error messages.

Hope this helps,

Frédéric Rinaldi · Answer

Justin Kuehlthau , 
 You can set a prefix and a suffix in the UI (see image below), but it will be static, meaning you cannot set something-{name}-contract.docx. 
 rafa