Page 662 Approval Request Entries

Base Application, System.Automation

src/Layers/W1/BaseApp/OtherCapabilities/Approvals/ApprovalRequestEntries.Page.al328 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 662 "Approval Request Entries"{    ApplicationArea = Suite;    AboutTitle = 'About Approval Request Entries';    AboutText = 'Manage and review approval request entries, including details about the documents awaiting approval, the approvers involved, and the status of each request.';    Caption = 'Approval Request Entries';    Editable = false;    PageType = List;    SourceTable = "Approval Entry";    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("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("Sequence No."; Rec."Sequence No.")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the order of approvers when an approval workflow involves more than one approver.';                }                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(Status; Rec.Status)                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the approval status for the entry:';                }                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.';                }                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(Amount; Rec.Amount)                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the total amount (excl. VAT) on the document awaiting approval.';                }                field("Amount (LCY)"; Rec."Amount (LCY)")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the total amount in LCY (excl. VAT) on the document awaiting approval.';                }                field("Currency Code"; Rec."Currency Code")                {                    ApplicationArea = Suite;                    ToolTip = 'Specifies the code of the currency of the amounts on the sales or purchase lines.';                }            }        }        area(factboxes)        {            systempart(Control1900383207; Links)            {                ApplicationArea = RecordLinks;                Visible = false;            }            systempart(Control1905767507; Notes)            {                ApplicationArea = Notes;            }        }    }    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';                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';                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        RecRef: RecordRef;    begin        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        if Usersetup.Get(UserId) then            if not Usersetup."Approval Administrator" then begin                Rec.FilterGroup(2);                Rec.SetCurrentKey("Sender ID");                Rec.SetFilter("Sender ID", '=%1', Usersetup."User ID");                Rec.FilterGroup(0);            end;        Rec.SetRange(Status);        Rec.SetRange("Due Date");    end;    var        Usersetup: Record "User Setup";        Overdue: Option Yes," ";        RecordIDText: Text;        ShowRecCommentsEnabled: Boolean;    local procedure FormatField(Rec: Record "Approval Entry"): Boolean    begin        if Rec.Status in [Rec.Status::Created, Rec.Status::Open] then begin            if Rec."Due Date" < Today then                exit(true);            exit(false);        end;    end;}