Blog Details
Blog Post Actions
Related
Recommended

Triggering Advanced Workflow processes in PHP customizations

Matt Marum
1 minute read time

An Advanced Workflow process can only be triggered once per PHP process or HTTP request. This is intended to prevent Sugar Administrators from defining infinitely looping processes. (A real catastrophe!) But what does this mean for PHP customizations?

Assume that you have an Advanced Workflow process enabled for the Contacts module that performs an update on this Contact each time it is saved. If you have an Accounts after_save logic hook that performs an update on each related Contact SugarBean then the process will only run against the first related Contact. Any other related Contact that gets saved during your logic hook execution will not have a process run.

This affects not just logic hooks but any other class of PHP customization such as custom API endpoints or jobs.

Workaround

If you really need to run that process more than once in the same request, here is a workaround:

use Sugarcrm\Sugarcrm\ProcessManager\Registry;

...

Registry\Registry::getInstance()->drop('triggered_starts');

Calling this method will clear the internal Advanced Workflow registry that keeps track of the triggered process starts. After calling this method, the same process can then be triggered again inside the same PHP process or HTTP request.

Careful use of this method can make sure that PHP customizations play nicely with processes defined in Advanced Workflow.

Parents Comment
  • in reply to Matt Marum

    Hi Matt Marum, Thanks for your help,

    In this case, using the alias I would use in file 1:

    use Sugarcrm\Sugarcrm\ProcessManager\Registry as RegistryA;

    and in File 2:

    use Sugarcrm\Sugarcrm\ProcessManager\Registry as RegistryB;

    right?

    Then how would I use the second line? 

    Registry\Registry::getInstance()->drop('triggered_starts');

    Would it stay the same or should I change it to:

    RegistryA\Registry::getInstance()->drop('triggered_starts');

    OR

    Registry\RegistryA::getInstance()->drop('triggered_starts');

    OR

    RegistryA\RegistryA::getInstance()->drop('triggered_starts');

    Can you help me with this issue?

    Regards,

Children
  • in reply to Marcel Lyyra

    The following works without causing any errors.

    use Sugarcrm\Sugarcrm\ProcessManager\Registry as RegistryA;
    use Sugarcrm\Sugarcrm\ProcessManager\Registry as RegistryB;

    function test()
    {
        RegistryA\Registry::getInstance()->drop('triggered_starts');
        RegistryB\Registry::getInstance()->drop('triggered_starts');
    }

    The alias from my previous example is for the namespace and not the class name. But conceptually, it all just comes down to avoiding name conflicts within your PHP files.

    For example, you could just as easily use the following which uses an alias for the class name instead of the namespace.

    use Sugarcrm\Sugarcrm\ProcessManager\Registry\Registry as RegistryA;
    use Sugarcrm\Sugarcrm\ProcessManager\Registry\Registry as RegistryB;

    function test()
    {
        RegistryA::getInstance()->drop('triggered_starts');
        RegistryB::getInstance()->drop('triggered_starts');
    }