Page 658 Approval Entries

Base Application, System.Automation

src/Layers/W1/BaseApp/OtherCapabilities/Approvals/ApprovalEntries.Page.al365 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Automation;using System.Security.User;page 658 "Approval Entries"{    ApplicationArea = Suite;    Caption = 'Approval Entries';    Editable = false;    PageType = List;    AboutTitle = 'About Approval Entries';    AboutText = 'Track, review, and manage the full history of document approval entries, monitor approval status and workflow details, and add comments or take action on approval requests.';    SourceTable = "Approval Entry";    SourceTableView = sorting("Table ID", "Document Type", "Document No.", "Date-Time Sent for Approval")                      order(ascending);    UsageCategory = Lists;    layout    {        area(content)        {            repeater(Control1)            {                ShowCaption = false;                field(Overdue; Overdue)                {                    ApplicationArea = Suite;                    Caption = 'Overdue';                    Editable = false;                    ToolTip = 'Specifies that the approval is overdue.';                }                field("Table ID"; Rec."Table ID")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the ID of the table where the record that is subject to approval is stored.';                    Visible = false;                }                field("Limit Type"; Rec."Limit Type")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the type of limit that applies to the approval template:';                }                field("Approval Type"; Rec."Approval Type")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies which approvers apply to this approval template:';                }                field("Document Type"; Rec."Document Type")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the type of document that an approval entry has been created for. Approval entries can be created for six different types of sales or purchase documents:';                    Visible = false;                }                field("Document No."; Rec."Document No.")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the document number copied from the relevant sales or purchase document, such as a purchase order or a sales quote.';                    Visible = false;                }                field(RecordIDText; RecordIDText)                {                    ApplicationArea = Suite;                    Caption = 'To Approve';                    ToolTip = 'Specifies the record that you are requested to approve.';                }                field(Details; Rec.RecordDetails())                {                    ApplicationArea = Suite;                    Caption = 'Details';                    ToolTip = 'Specifies the record that the approval is related to.';                }                field("Sequence No."; Rec."Sequence No.")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the order of approvers when an approval workflow involves more than one approver.';                }                field(Status; Rec.Status)                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the approval status for the entry:';                }                field("Sender ID"; Rec."Sender ID")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the ID of the user who sent the approval request for the document to be approved.';                    trigger OnDrillDown()                    var                        UserMgt: Codeunit "User Management";                    begin                        UserMgt.DisplayUserInformation(Rec."Sender ID");                    end;                }                field("Salespers./Purch. Code"; Rec."Salespers./Purch. Code")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the code for the salesperson or purchaser that was in the document to be approved. It is not a mandatory field, but is useful if a salesperson or a purchaser responsible for the customer/vendor needs to approve the document before it is processed.';                }                field("Approver ID"; Rec."Approver ID")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the ID of the user who must approve the document.';                    trigger OnDrillDown()                    var                        UserMgt: Codeunit "User Management";                    begin                        UserMgt.DisplayUserInformation(Rec."Approver ID");                    end;                }                field("Currency Code"; Rec."Currency Code")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the code of the currency of the amounts on the sales or purchase lines.';                }                field("Amount (LCY)"; Rec."Amount (LCY)")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the total amount (excl. VAT) on the document awaiting approval. The amount is stated in the local currency.';                }                field("Available Credit Limit (LCY)"; Rec."Available Credit Limit (LCY)")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the remaining credit (in LCY) that exists for the customer.';                }                field("Date-Time Sent for Approval"; Rec."Date-Time Sent for Approval")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the date and the time that the document was sent for approval.';                }                field("Last Date-Time Modified"; Rec."Last Date-Time Modified")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the date when the approval entry was last modified. If, for example, the document approval is canceled, this field will be updated accordingly.';                }                field("Last Modified By User ID"; Rec."Last Modified By User ID")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the ID of the user who last modified the approval entry. If, for example, the document approval is canceled, this field will be updated accordingly.';                    trigger OnDrillDown()                    var                        UserMgt: Codeunit "User Management";                    begin                        UserMgt.DisplayUserInformation(Rec."Last Modified By User ID");                    end;                }                field(Comment; Rec.Comment)                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies whether there are comments relating to the approval of the record. If you want to read the comments, choose the field to open the Approval Comment Sheet window.';                }                field("Due Date"; Rec."Due Date")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies when the record must be approved, by one or more approvers.';                }            }        }        area(factboxes)        {            part(Change; "Workflow Change List FactBox")            {                ApplicationArea = Suite;                Editable = false;                Enabled = false;                ShowFilter = false;                UpdatePropagation = SubPart;                Visible = ShowChangeFactBox;            }            systempart(Control5; Links)            {                ApplicationArea = RecordLinks;                Visible = false;            }            systempart(Control4; Notes)            {                ApplicationArea = Notes;                Visible = true;            }        }    }    actions    {        area(navigation)        {            group("&Show")            {                Caption = '&Show';                Image = View;                action("Record")                {                    ApplicationArea = Suite;                    Caption = 'Record';                    Enabled = ShowRecCommentsEnabled;                    Image = Document;                    ToolTip = 'Open the document, journal line, or card that the approval request is for.';                    trigger OnAction()                    begin                        Rec.ShowRecord();                    end;                }                action(Comments)                {                    ApplicationArea = Suite;                    Caption = 'Comments';                    Enabled = ShowRecCommentsEnabled;                    Image = ViewComments;                    ToolTip = 'View or add comments for the record.';                    trigger OnAction()                    var                        ApprovalsMgmt: Codeunit "Approvals Mgmt.";                        RecRef: RecordRef;                    begin                        RecRef.Get(Rec."Record ID to Approve");                        Clear(ApprovalsMgmt);                        ApprovalsMgmt.GetApprovalCommentForWorkflowStepInstanceID(RecRef, Rec."Workflow Step Instance ID");                    end;                }                action("O&verdue Entries")                {                    ApplicationArea = Suite;                    Caption = 'O&verdue Entries';                    Image = OverdueEntries;                    ToolTip = 'View approval requests that are overdue.';                    trigger OnAction()                    begin                        Rec.SetFilter(Status, '%1|%2', Rec.Status::Created, Rec.Status::Open);                        Rec.SetFilter("Due Date", '<%1', Today);                    end;                }                action("All Entries")                {                    ApplicationArea = Suite;                    Caption = 'All Entries';                    Image = Entries;                    ToolTip = 'View all approval entries.';                    trigger OnAction()                    begin                        Rec.SetRange(Status);                        Rec.SetRange("Due Date");                    end;                }            }        }        area(processing)        {            action("&Delegate")            {                ApplicationArea = Suite;                Caption = '&Delegate';                Enabled = DelegateEnable;                Image = Delegate;                ToolTip = 'Delegate the approval request to another approver that has been set up as your substitute approver.';                trigger OnAction()                var                    ApprovalEntry: Record "Approval Entry";                    ApprovalsMgmt: Codeunit "Approvals Mgmt.";                begin                    CurrPage.SetSelectionFilter(ApprovalEntry);                    ApprovalsMgmt.DelegateApprovalRequests(ApprovalEntry);                end;            }        }        area(Promoted)        {            group(Category_Process)            {                Caption = 'Process', Comment = 'Generated from the PromotedActionCategories property index 1.';                actionref("&Delegate_Promoted"; "&Delegate")                {                }                actionref(Record_Promoted; Record)                {                }                actionref(Comments_Promoted; Comments)                {                }                group(Category_Show)                {                    Caption = 'Show';                    actionref("All Entries_Promoted"; "All Entries")                    {                    }                    actionref("O&verdue Entries_Promoted"; "O&verdue Entries")                    {                    }                }            }        }    }    trigger OnAfterGetCurrRecord()    var        [SecurityFiltering(SecurityFilter::Filtered)]        RecRef: RecordRef;    begin        ShowChangeFactBox := CurrPage.Change.PAGE.SetFilterFromApprovalEntry(Rec);        DelegateEnable := Rec.CanCurrentUserEdit();        ShowRecCommentsEnabled := RecRef.Get(Rec."Record ID to Approve");    end;    trigger OnAfterGetRecord()    begin        Overdue := Overdue::" ";        if FormatField(Rec) then            Overdue := Overdue::Yes;        RecordIDText := Format(Rec."Record ID to Approve", 0, 1);    end;    trigger OnOpenPage()    begin        Rec.MarkAllWhereUserisApproverOrSender();    end;    var        Overdue: Option Yes," ";        RecordIDText: Text;        ShowChangeFactBox: Boolean;        DelegateEnable: Boolean;        ShowRecCommentsEnabled: Boolean;    procedure SetRecordFilters(TableId: Integer; DocumentType: Enum "Approval Document Type"; DocumentNo: Code[20])    begin        if TableId <> 0 then begin            Rec.FilterGroup(2);            Rec.SetCurrentKey("Table ID", "Document Type", "Document No.", "Date-Time Sent for Approval");            Rec.SetRange("Table ID", TableId);            Rec.SetRange("Document Type", DocumentType);            if DocumentNo <> '' then                Rec.SetRange("Document No.", DocumentNo);            Rec.FilterGroup(0);        end;    end;    local procedure FormatField(ApprovalEntry: Record "Approval Entry"): Boolean    begin        if Rec.Status in [Rec.Status::Created, Rec.Status::Open] then begin            if ApprovalEntry."Due Date" < Today then                exit(true);            exit(false);        end;    end;    procedure CalledFrom()    begin        Overdue := Overdue::" ";    end;}