Page 1813 Cust. Approval WF Setup Wizard

Base Application, System.Automation

src/Layers/W1/BaseApp/System/Workflow/CustApprovalWFSetupWizard.Page.al495 lines, Copyright (c) Microsoft Corporation. MIT

namespace System.Automation;using Microsoft.Sales.Customer;using System.Environment;using System.Environment.Configuration;using System.Reflection;using System.Utilities;page 1813 "Cust. Approval WF Setup Wizard"{    Caption = 'Customer Approval Workflow Setup';    DeleteAllowed = false;    InsertAllowed = false;    LinksAllowed = false;    PageType = NavigatePage;    ShowFilter = false;    SourceTable = "Approval Workflow Wizard";    SourceTableTemporary = true;    layout    {        area(content)        {            group(Control96)            {                Editable = false;                ShowCaption = false;                Visible = TopBannerVisible and not DoneVisible;#pragma warning disable AA0100                field("MediaResourcesStandard.""Media Reference"""; MediaResourcesStandard."Media Reference")#pragma warning restore AA0100                {                    ApplicationArea = Suite;                    Editable = false;                    ShowCaption = false;                }            }            group(Control98)            {                Editable = false;                ShowCaption = false;                Visible = TopBannerVisible and DoneVisible;#pragma warning disable AA0100                field("MediaResourcesDone.""Media Reference"""; MediaResourcesDone."Media Reference")#pragma warning restore AA0100                {                    ApplicationArea = Suite;                    Editable = false;                    ShowCaption = false;                }            }            group(Step1)            {                Caption = '';                Visible = IntroVisible;                group("Para1.1")                {                    Caption = 'Welcome to Customer Approval Workflow Setup';                    group("Para1.1.1")                    {                        Caption = '';                        InstructionalText = 'You can create approval workflows that automatically notify an approver when a user tries to create or change a customer card.';                    }                }                group("Para1.2")                {                    Caption = 'Let''s go!';                    InstructionalText = 'Choose Next to specify basic approval workflow settings for changing a customer card.';                }            }            group(Step2)            {                Caption = '';                Visible = CustomerApproverSetupVisible;                group("Para2.1")                {                    Caption = '';                    group("Para2.1.1")                    {                        Caption = '';                        InstructionalText = 'Choose who is authorized to approve or reject new or changed customer cards.';                        field("Approver ID"; Rec."Approver ID")                        {                            ApplicationArea = Suite;                            Caption = 'Approver';                            LookupPageID = "Approval User Setup";                            trigger OnValidate()                            begin                                CanEnableNext();                            end;                        }                    }                }                group("Para2.2")                {                    Caption = '';                    group("Para2.2.1")                    {                        Caption = 'Choose if the approval process starts automatically or if the user must start the process.';                        field("App. Trigger"; Rec."App. Trigger")                        {                            ApplicationArea = Suite;                            Caption = 'The workflow starts when';                            trigger OnValidate()                            begin                                CanEnableNext();                            end;                        }                    }                }            }            group(Step3)            {                Caption = '';                Visible = CustomerAutoAppDetailsVisible;                group("Para3.1")                {                    Caption = '';                    InstructionalText = 'Choose criteria for when the approval process starts automatically.';                    grid("Para3.1.1")                    {                        Caption = '';                        GridLayout = Rows;                        group("Para3.1.1.1")                        {                            Caption = '';                            InstructionalText = 'The workflow starts when:';                            field(CustomerFieldCap; CustomerFieldCaption)                            {                                ApplicationArea = Suite;                                Caption = 'Field';                                ShowCaption = false;                                trigger OnLookup(var Text: Text): Boolean                                var                                    FieldRec: Record "Field";                                    FieldSelection: Codeunit "Field Selection";                                begin                                    FindAndFilterToField(FieldRec, Text);                                    FieldRec.SetRange("Field Caption");                                    FieldRec.SetRange("No.");                                    if FieldSelection.Open(FieldRec) then                                        SetCustomerField(FieldRec."No.");                                end;                                trigger OnValidate()                                var                                    FieldRec: Record "Field";                                    FieldSelection: Codeunit "Field Selection";                                begin                                    if CustomerFieldCaption = '' then begin                                        SetCustomerField(0);                                        exit;                                    end;                                    if not FindAndFilterToField(FieldRec, CustomerFieldCaption) then                                        Error(FieldNotExistErr, CustomerFieldCaption);                                    if FieldRec.Count = 1 then begin                                        SetCustomerField(FieldRec."No.");                                        exit;                                    end;                                    if FieldSelection.Open(FieldRec) then                                        SetCustomerField(FieldRec."No.")                                    else                                        Error(FieldNotExistErr, CustomerFieldCaption);                                end;                            }                            label(is)                            {                                ApplicationArea = Suite;                                Caption = 'is';                                ShowCaption = false;                            }                            field("Field Operator"; Rec."Field Operator")                            {                                ApplicationArea = Suite;                                Caption = 'Operator';                                ShowCaption = false;                            }                        }                    }                    group("Para3.1.2")                    {                        Caption = 'Specify the message to display when the workflow starts.';                        field("Custom Message"; Rec."Custom Message")                        {                            ApplicationArea = Suite;                            Caption = 'Message';                            ShowCaption = false;                        }                    }                }            }            group(Step10)            {                Caption = '';                Visible = DoneVisible;                group("Para10.1")                {                    Caption = '';                    InstructionalText = 'Customer Approval Workflow Overview';                    field(Overview; SummaryText)                    {                        ApplicationArea = Suite;                        Editable = false;                        MultiLine = true;                        ShowCaption = false;                        Style = StrongAccent;                        StyleExpr = true;                    }                }                group("Para10.2")                {                    Caption = 'That''s it!';                    InstructionalText = 'Choose Finish to enable the workflow with the specified settings.';                }            }        }    }    actions    {        area(processing)        {            action(PreviousPage)            {                ApplicationArea = Suite;                Caption = 'Back';                Enabled = BackEnabled;                Image = PreviousRecord;                InFooterBar = true;                trigger OnAction()                begin                    NextStep(true);                end;            }            action(NextPage)            {                ApplicationArea = Suite;                Caption = 'Next';                Enabled = NextEnabled;                Image = NextRecord;                InFooterBar = true;                trigger OnAction()                begin                    NextStep(false);                end;            }            action(Finish)            {                ApplicationArea = Suite;                Caption = 'Finish';                Enabled = FinishEnabled;                Image = Approve;                InFooterBar = true;                trigger OnAction()                var                    GuidedExperience: Codeunit "Guided Experience";                    ApprovalWorkflowSetupMgt: Codeunit "Approval Workflow Setup Mgt.";                begin                    ApprovalWorkflowSetupMgt.ApplyCustomerWizardUserInput(Rec);                    GuidedExperience.CompleteAssistedSetup(ObjectType::Page, PAGE::"Cust. Approval WF Setup Wizard");                    CurrPage.Close();                end;            }        }    }    trigger OnInit()    begin        if not Rec.Get() then begin            Rec.Init();            SetDefaultValues();            Rec.Insert();        end;        LoadTopBanners();    end;    trigger OnOpenPage()    begin        ShowIntroStep();    end;    trigger OnQueryClosePage(CloseAction: Action): Boolean    var        GuidedExperience: Codeunit "Guided Experience";    begin        if CloseAction = ACTION::OK then            if GuidedExperience.AssistedSetupExistsAndIsNotComplete(ObjectType::Page, PAGE::"Cust. Approval WF Setup Wizard") then                if not Confirm(NAVNotSetUpQst, false) then                    exit(false);    end;    var        MediaRepositoryStandard: Record "Media Repository";        MediaRepositoryDone: Record "Media Repository";        MediaResourcesStandard: Record "Media Resources";        MediaResourcesDone: Record "Media Resources";        ClientTypeManagement: Codeunit "Client Type Management";        Step: Option Intro,"Customer Approver Setup","Automatic Approval Setup",Done;        BackEnabled: Boolean;        NextEnabled: Boolean;        FinishEnabled: Boolean;        TopBannerVisible: Boolean;        IntroVisible: Boolean;        CustomerApproverSetupVisible: Boolean;        CustomerAutoAppDetailsVisible: Boolean;        DoneVisible: Boolean;        NAVNotSetUpQst: Label 'Customer Approval has not been set up.\\Are you sure that you want to exit?';        MandatoryApproverErr: Label 'You must select an approver before continuing.', Comment = '%1 = User Name';        CustomerFieldCaption: Text[250];        FieldNotExistErr: Label 'Field %1 does not exist.', Comment = '%1 = Field Caption';        ManualTriggerTxt: Label 'An approval request will be sent to the user %1 when the user sends the request manually.', Comment = '%1 = User Name (eg. An approval request will be sent to the user Domain/Username when the user sends the request manually.)';        AutoTriggerTxt: Label 'An approval request will be sent to the user %1 when the value in the %2 field is %3.', Comment = '%1 = User Name, %2 = Field caption, %3 = Of of this 3 values: Increased, Decreased, Changed (eg. An approval request will be sent to the user Domain/Username when the value in the Credit Limit (LCY) field is Increased.)';        SummaryText: Text;    local procedure NextStep(Backwards: Boolean)    begin        if Backwards then            Step := Step - 1        else begin            if CustomerApproverSetupVisible then                ValidateApprover();            if CustomerAutoAppDetailsVisible then                ValidateFieldSelection();            Step := Step + 1;        end;        case Step of            Step::Intro:                ShowIntroStep();            Step::"Customer Approver Setup":                ShowApprovalUserSetupDetailsStep();            Step::"Automatic Approval Setup":                if Rec."App. Trigger" = Rec."App. Trigger"::"The user changes a specific field" then                    ShowCustomerApprovalDetailsStep()                else                    NextStep(Backwards);            Step::Done:                ShowDoneStep();        end;        CurrPage.Update(true);    end;    local procedure ShowIntroStep()    begin        ResetWizardControls();        IntroVisible := true;        BackEnabled := false;    end;    local procedure ShowApprovalUserSetupDetailsStep()    begin        ResetWizardControls();        CustomerApproverSetupVisible := true;    end;    local procedure ShowCustomerApprovalDetailsStep()    begin        ResetWizardControls();        CustomerAutoAppDetailsVisible := true;        SetCustomerField(Rec.Field);    end;    local procedure ShowDoneStep()    begin        ResetWizardControls();        DoneVisible := true;        NextEnabled := false;        FinishEnabled := true;        if Rec."App. Trigger" = Rec."App. Trigger"::"The user sends an approval requests manually" then            SummaryText := StrSubstNo(ManualTriggerTxt, Rec."Approver ID");        if Rec."App. Trigger" = Rec."App. Trigger"::"The user changes a specific field" then begin            Rec.CalcFields("Field Caption");            SummaryText := StrSubstNo(AutoTriggerTxt, Rec."Approver ID", Rec."Field Caption", Rec."Field Operator");        end;        SummaryText := ConvertStr(SummaryText, '\', '/');    end;    local procedure ResetWizardControls()    begin        // Buttons        BackEnabled := true;        NextEnabled := true;        FinishEnabled := false;        // Tabs        IntroVisible := false;        CustomerApproverSetupVisible := false;        CustomerAutoAppDetailsVisible := false;        DoneVisible := false;    end;    local procedure SetDefaultValues()    var        Workflow: Record Workflow;        WorkflowRule: Record "Workflow Rule";        WorkflowStep: Record "Workflow Step";        WorkflowStepArgument: Record "Workflow Step Argument";        WorkflowSetup: Codeunit "Workflow Setup";        WorkflowResponseHandling: Codeunit "Workflow Response Handling";        WorkflowCode: Code[20];    begin        Rec.TableNo := DATABASE::Customer;        WorkflowCode := WorkflowSetup.GetWorkflowTemplateCode(WorkflowSetup.CustomerCreditLimitChangeApprovalWorkflowCode());        if Workflow.Get(WorkflowCode) then begin            WorkflowStep.SetRange("Workflow Code", WorkflowCode);            WorkflowStep.SetRange("Function Name", WorkflowResponseHandling.ShowMessageCode());            if WorkflowStep.FindFirst() then begin                WorkflowStepArgument.Get(WorkflowStep.Argument);                Rec."Custom Message" := WorkflowStepArgument.Message;            end;            WorkflowRule.SetRange("Workflow Code", WorkflowCode);            if WorkflowRule.FindFirst() then begin                Rec.Field := WorkflowRule."Field No.";                Rec."Field Operator" := WorkflowRule.Operator;            end;        end;    end;    local procedure ValidateApprover()    begin        if Rec."Approver ID" = '' then            Error(MandatoryApproverErr);    end;    local procedure ValidateFieldSelection()    begin    end;    local procedure CanEnableNext()    begin        NextEnabled := true;    end;    local procedure SetCustomerField(FieldNo: Integer)    begin        Rec.Field := FieldNo;        Rec.CalcFields("Field Caption");        CustomerFieldCaption := Rec."Field Caption";    end;    local procedure FindAndFilterToField(var FieldRec: Record "Field"; CaptionToFind: Text): Boolean    begin        FieldRec.FilterGroup(2);        FieldRec.SetRange(TableNo, DATABASE::Customer);        FieldRec.SetFilter(Type, StrSubstNo('%1|%2|%3|%4|%5|%6|%7|%8|%9|%10|%11|%12|%13',            FieldRec.Type::Boolean,            FieldRec.Type::Text,            FieldRec.Type::Code,            FieldRec.Type::Decimal,            FieldRec.Type::Integer,            FieldRec.Type::BigInteger,            FieldRec.Type::Date,            FieldRec.Type::Time,            FieldRec.Type::DateTime,            FieldRec.Type::DateFormula,            FieldRec.Type::Option,            FieldRec.Type::Duration,            FieldRec.Type::RecordID));        FieldRec.SetRange(Class, FieldRec.Class::Normal);        FieldRec.SetFilter(ObsoleteState, '<>%1', FieldRec.ObsoleteState::Removed);        if CaptionToFind = Rec."Field Caption" then            FieldRec.SetRange("No.", Rec.Field)        else            FieldRec.SetFilter("Field Caption", '%1', '@' + CaptionToFind + '*');        exit(FieldRec.FindFirst());    end;    local procedure LoadTopBanners()    begin        if MediaRepositoryStandard.Get('AssistedSetup-NoText-400px.png', Format(ClientTypeManagement.GetCurrentClientType())) and           MediaRepositoryDone.Get('AssistedSetupDone-NoText-400px.png', Format(ClientTypeManagement.GetCurrentClientType()))        then            if MediaResourcesStandard.Get(MediaRepositoryStandard."Media Resources Ref") and               MediaResourcesDone.Get(MediaRepositoryDone."Media Resources Ref")            then                TopBannerVisible := MediaResourcesDone."Media Reference".HasValue;    end;}