Business Process Flows - TypeScript methods extensions

[DejWass]

Hi fellas,
in past few days I struggled a lot with one bug on our Real Estate client.
I needed to hide field Agent when value of the field Direct is equal to Yes.

The issue was that it was not working in all cases and I was not able to found out why.

I had to use TS method to hide the field Agent. You probably know that when you try to getControl of an attribute in BPF you will use header_process_ prefix.
This method was working fine except situation when I had BPF from Lead to Opportunity. This BPF has 4 branches and that was causing the issue.

The attribute Agent is there 4 times. It means that when I am trying to get control header_process_ in this BPF it will get only the first one. Because of that this method was not working:

public static SetAgentRequirement(executionContext) {
            //@ts-ignore
            var formContext = TALXIS.Utility.Apps.Start.UCIClientExtensions.TryGetFormContext(executionContext);

            var direct = formContext.data.entity.attributes.get("talxis_directcontact").getValue();
            var stage = formContext.data.process.getActiveStage().getName();
            if (direct === false && stage !== "Active") {
                formContext.getControl("header_process_talxis_referredbyaccountid")?.getAttribute()?.setRequiredLevel("required");
                formContext.getControl("talxis_referredbyaccountid")?.setVisible(true);
                formContext.getControl("header_process_talxis_referredbyaccountid")?.setVisible(true); 
            }
            else if (direct === true) {
                formContext.getControl("header_process_talxis_referredbyaccountid")?.getAttribute()?.setRequiredLevel("none");
                formContext.getControl("header_process_talxis_referredbyaccountid")?.getAttribute()?.setValue(null);
                formContext.getControl("talxis_referredbyaccountid_1")?.setVisible(false)
                formContext.getControl("header_process_talxis_referredbyaccountid")?.setVisible(false); 
            }
        }

Those "duplicated" attributes are added with this suffix:

First duplicate: _1
Second duplicate: _2,
Third duplicate: _3
...

It means that the method have to be defined this way to access all attributes:

public static SetAgentRequirement(executionContext) {
            //@ts-ignore
            var formContext = TALXIS.Utility.Apps.Start.UCIClientExtensions.TryGetFormContext(executionContext);

            var direct = formContext.data.entity.attributes.get("talxis_directcontact").getValue();
            var stage = formContext.data.process.getActiveStage().getName();
            if (direct === false && stage !== "Active") {
                formContext.getControl("header_process_talxis_referredbyaccountid")?.getAttribute()?.setRequiredLevel("required");
                formContext.getControl("talxis_referredbyaccountid")?.setVisible(true);
                //controls in multiple branches of BPF are "duplicated". In case of Lead Process BPF there are 4 branches and we need to add this method on all of them
                formContext.getControl("header_process_talxis_referredbyaccountid")?.setVisible(true); //Office Leasing
                formContext.getControl("header_process_talxis_referredbyaccountid_1")?.setVisible(true); //Qubes
                formContext.getControl("header_process_talxis_referredbyaccountid_2")?.setVisible(true); //HubHub (First branch)
                formContext.getControl("header_process_talxis_referredbyaccountid_3")?.setVisible(true); //HubHub (Second branch)
            }
            else if (direct === true) {
                formContext.getControl("header_process_talxis_referredbyaccountid")?.getAttribute()?.setRequiredLevel("none");
                formContext.getControl("header_process_talxis_referredbyaccountid")?.getAttribute()?.setValue(null);
                formContext.getControl("talxis_referredbyaccountid_1")?.setVisible(false)
                //controls in multiple branches of BPF are "duplicated". In case of Lead Process BPF there are 4 branches and we need to add this method on all of them
                formContext.getControl("header_process_talxis_referredbyaccountid")?.setVisible(false); //Office Leasing 
                formContext.getControl("header_process_talxis_referredbyaccountid_1")?.setVisible(false); //Qubes
                formContext.getControl("header_process_talxis_referredbyaccountid_2")?.setVisible(false); //HubHub (First branch)
                formContext.getControl("header_process_talxis_referredbyaccountid_3")?.setVisible(false); //HubHub (Second branch)
            }
        }

This bug really haunted me for a while. If you have similar issue you will probably have to use Console (F12) to access those duplicated attributed since you cannot find them in source control.
Simply open Console and write command:

Xrm.Page.getControl()

You will get all controls on the page: