The post is related to the masterdata synchronization.

I wanted to give end-users an explanation why they cannot change some of the fields in a synchronized records.  I  decided to create a generic way of alerting the end-user, like you see in the screenshot below, and also to lock any fields that is synchronized.

So if a record is originating from another master-company, then the following yellow text will be visible. Doing this on a single form is surely easy, but I wanted to create a generic solution that has Zero footprint, and NOT making any changes to any standard form. 

Can it be done ?  Yes 🙂

So what I did, was to create a event handler on the info.formNotify():

Then the code looks like this (the code contains some ColSync* references, but you see the idea:

public static void colSyncEnableFields(XppPrePostArgs _args)
{
    FormRun                 formRun;
    FormDesign              formDesign;
    FormNotify              event;
    FormNotifyEventArgs     eventArgs;
    ColSyncCache            colSyncCache;
    Common                  common;
    ColSyncLine             colSyncLine;
    ColSyncTable            colSyncTable;
    ColSyncDefinition       colSyncDefinition;
    ColSyncDestinations     colSyncDestinations;
    FormGroupControl        actionBarGroup;
    FormActionPaneControl   actionPane;
    FormGroupControl        firstGroup;
    int                     defaultBackgroundColor;
    FormStaticTextControl   actionBarMessageText;
    int                     i;

    #define.SyncActionBarGroup('SyncActionBarGroup')
    #define.SyncActionBarMessageText('SyncBarMessageText')

    event     = _args.getArg('event');
    eventArgs = _args.getArg('eventArgs');

    switch (event)
    {
        case FormNotify::RecordChange:
            if ((eventArgs != null) &&
                (eventArgs.formDataSource()))
            {
                formRun   = _args.getArg('formRun');
                colSyncCache = ColSyncCache::construct();
                common = eventArgs.formDataSource().getFirst(true) ? eventArgs.formDataSource().getFirst(true) : eventArgs.formDataSource().cursor();
                if (common.RecId &&
                    colSyncCache.isSyncEnabledDestination(common))
                {
                    formDesign = formrun.design();
                    for (i=1; i<=formDesign.controlCount(); i++)
                    {
                        if ((formDesign.controlNum(i).handle() == classNum(FormActionPaneControl)))
                        {
                            actionPane = formDesign.controlNum(i);
                            break;
                        }
                    }
                    formRun.lock();

                    if (actionPane != null)
                    {
                        for (i=1; i<=formDesign.controlCount(); i++)
                        {
                            if ((formDesign.controlNum(i).handle() == classNum(FormGroupControl) &&
                                 formDesign.controlNum(i).name() == #SyncActionBarGroup ))
                            {
                                actionBarGroup = formDesign.controlNum(i);
                                break;
                            }
                        }

                        if (!actionBarGroup)
                            actionBarGroup = formDesign.addControl(FormControlType::Group, #SyncActionBarGroup, actionPane);
                    }
                    // add directly to top of form design
                    else
                    {
                        for (i=1; i<=formDesign.controlCount(); i++)
                        {
                            if ((formDesign.controlNum(i).handle() == classNum(FormGroupControl) &&
                                 formDesign.controlNum(i).name() == #SyncActionBarGroup ))
                            {
                                actionBarGroup = formDesign.controlNum(i);
                                break;
                            }
                        }

                        if (!actionBarGroup)
                        {
                            // find the first group control on form (if one exists)
                            for (i=1; i<=formDesign.controlCount(); i++)
                            {
                                if ((formDesign.controlNum(i).handle() == classNum(FormGroupControl)))
                                {
                                    firstGroup = formDesign.controlNum(i);
                                    break;
                                }
                            }
                            if(firstGroup)
                            {
                                actionBarGroup = firstGroup.addControl(FormControlType::Group, #SyncActionBarGroup);
                                actionBarGroup.top(FormTop::Auto);
                            }
                            else
                            {
                                actionBarGroup = formDesign.addControl(FormControlType::Group,#SyncActionBarGroup);
                                actionBarGroup.top(1, FormTop::Auto);
                            }
                        }
                    }

                    defaultBackgroundColor = formDesign.backgroundColor();
                    actionBarGroup.frameType(FormFrameType::None);
                    actionBarGroup.height(27);
                    actionBarGroup.hideIfEmpty(false);
                    actionBarGroup.topMargin(1);
                    actionBarGroup.bottomMargin(1);
                    actionBarGroup.widthMode(FormWidth::ColumnWidth);
                    actionBarGroup.colorScheme(FormColorScheme::RGB);
                    actionBarGroup.verticalSpacingValue(0);
                    if (System.Windows.SystemParameters::get_HighContrast())
                    {
                        actionBarGroup.colorScheme(FormColorScheme::WindowsPalette);
                        actionBarGroup.backgroundColor(WindowsPalette::TooltipBackground);
                    }
                    else
                    {
                        actionBarGroup.colorScheme(FormColorScheme::RGB);
                        actionBarGroup.backgroundColor(WinAPI::RGB2int(255,255,153));
                    }
                    // don't reserve space for details forms
                    if (formDesign.style() == FormStyle::DetailsFormMaster || formDesign.style() == FormStyle::DetailsFormTransaction)
                    {
                        actionBarGroup.visible(false);
                    }

                    for (i=1; i<=actionBarGroup.controlCount(); i++)
                    {
                        if ((actionBarGroup.controlNum(i).handle() == classNum(FormStaticTextControl)))
                        {
                            actionBarMessageText = actionBarGroup.controlNum(i);
                            if (actionBarMessageText && actionBarMessageText.name() == #SyncActionBarMessageText)
                                break;
                        }
                    }

                    if (!actionBarMessageText)
                    {
                        actionBarMessageText = actionBarGroup.addControl(FormControlType::StaticText, #SyncActionBarMessageText, actionBarGroup);
                    }
                    actionBarMessageText.backStyle(FormBackStyle::Opaque);
                    actionBarMessageText.colorScheme(FormColorScheme::RGB);
                    actionBarMessageText.backgroundColor(WinAPI::RGB2int(255,255,153));
                    actionBarMessageText.widthMode(FormWidth::ColumnWidth);
                    actionBarMessageText.text(strFmt("@SYN112"));
                    actionBarMessageText.visible(true);
                    formRun.unLock();

                    while select  SyncFieldId from  colSyncLine group by SyncFieldId
                            where   colSyncLine.SyncTableId == eventArgs.formDataSource().table()
                                &&  colSyncLine.SyncType == ColSyncType::SynchronizeField
                        exists join colSyncTable
                            where   colSyncTable.SyncId == colSyncLine.SyncId
                                &&  colSyncTable.SyncTableId == colSyncLine.SyncTableId
                                &&  colSyncTable.SyncActive == NoYes::Yes
                        exists join colSyncDefinition
                            where   colSyncDefinition.SyncId == colSyncLine.SyncId
                                &&  colSyncDefinition.SyncActive == NoYes::Yes
                        exists join colSyncDestinations
                            where   colSyncDestinations.SyncId == colSyncLine.SyncId
                                &&  colSyncDestinations.ToDataAreaId == common.dataAreaId
                                &&  colSyncDestinations.LockSyncFields == true
                    {
                        eventArgs.formDataSource().object(colSyncLine.SyncFieldId).allowEdit(false);
                    }
                    eventArgs.formDataSource().allowCreate(false);
                    eventArgs.formDataSource().allowDelete(false);
                }
                else if (common.RecId &&
                         colSyncCache.isGlobalTableEnabled(common))
                {
                    eventArgs.formDataSource().allowCreate(false);
                    eventArgs.formDataSource().allowEdit(false);
                    eventArgs.formDataSource().allowDelete(false);
                }
            }
        break;
    }
}