Page 6105 Inbound E-Documents
src/Apps/W1/EDocument/App/src/Document/Inbound/InboundEDocuments.Page.al642 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 Microsoft.eServices.EDocument;using Microsoft.eServices.EDocument.Processing.Import;using Microsoft.eServices.EDocument.Processing.Import.Purchase;using Microsoft.EServices.EDocument.Processing.Import.Sales;using Microsoft.eServices.EDocument.Processing.Message;using Microsoft.Foundation.Attachment;using Microsoft.Purchases.Vendor;using System.Agents;using System.Agents.TaskPane;using System.Environment;page 6105 "Inbound E-Documents"{ ApplicationArea = Basic, Suite; SourceTable = "E-Document"; PageType = List; RefreshOnActivate = true; UsageCategory = Lists; Editable = true; Extensible = false; DeleteAllowed = true; InsertAllowed = false; ModifyAllowed = false; SourceTableView = sorting("Due Date") order(ascending) where(Direction = const("E-Document Direction"::Incoming)); layout { area(Content) { repeater(DocumentList) { ShowCaption = false; Editable = false; field("Entry No"; Rec."Entry No") { Caption = 'Entry No.'; ToolTip = 'Specifies the unique number of the document.'; Visible = false; } field("Document Name"; DocumentNameTxt) { Caption = 'Document'; ToolTip = 'Specifies the unique name for the document.'; trigger OnDrillDown() begin EDocumentHelper.OpenDraftPage(Rec); end; } field(ConfirmedVendorName; ConfirmedVendorTxt) { Caption = 'Vendor Name'; ToolTip = 'Specifies the bill-to/pay-to name of the document that was confirmed by the user during processing.'; trigger OnDrillDown() var Vendor: Record Vendor; VendorCardPage: Page "Vendor Card"; begin if Rec."Bill-to/Pay-to No." = '' then exit; Vendor.Get(Rec."Bill-to/Pay-to No."); Vendor.SetRecFilter(); VendorCardPage.SetRecord(Vendor); VendorCardPage.RunModal(); end; } field("Import Processing Status"; Rec."Import Processing Status") { Caption = 'Processing Status'; ToolTip = 'Specifies the stage in which the processing of this document is in.'; } field("Document Date"; Rec."Document Date") { Caption = 'Document Date'; ToolTip = 'Specifies the date of the document.'; } field("Due Date"; Rec."Due Date") { Caption = 'Due Date'; ToolTip = 'Specifies the due date of the document.'; } field(TaskID; AgentTask.ID) { Caption = 'Agent Task No.'; ToolTip = 'Specifies the task number for the document.'; Editable = false; ExtendedDatatype = Task; BlankNumbers = BlankZero; trigger OnDrillDown() var AgentTaskCU: Codeunit "Agent Task"; TaskPane: Codeunit "Task Pane"; begin if AgentTask.ID = 0 then exit; // An archived agent is not resolvable in the task pane, so its tasks are shown // as log entries instead, which keeps them reachable for auditing. if AgentTask."Agent Substate" = AgentTask."Agent Substate"::Archived then AgentTaskCU.OpenAgentTaskLogEntries(AgentTask.ID) else TaskPane.ShowTask(AgentTask.ID); end; }#if not CLEAN28 field(TaskStatus; AgentTask.Status) { Caption = 'Task Status'; ToolTip = 'Specifies the status of the agent task for this document.'; Editable = false; Visible = false; ObsoleteState = Pending; ObsoleteReason = 'Replaced by the AgentTaskStatus field.'; ObsoleteTag = '28.0'; }#endif field(AgentTaskStatus; AgentTaskStatus) { Caption = 'Agent Task Status'; ToolTip = 'Specifies the status of the agent task for this document.'; Editable = false; }#if not CLEAN29 field("Vendor Name"; EDocumentPurchaseHeader."Vendor Company Name") { Caption = 'Sender'; ToolTip = 'Specifies the vendor name of the document.'; ObsoleteState = Pending; ObsoleteReason = 'Replaced by the SenderName field.'; ObsoleteTag = '29.0'; }#endif field(SenderName; SenderNameTxt) { Caption = 'Sender'; ToolTip = 'Specifies the sender name of the document.'; } field(SystemCreatedAt; Rec.SystemCreatedAt) { Caption = 'Received At'; ToolTip = 'Specifies the date and time when the document was created.'; } field(Service; Rec.Service) { Visible = false; Caption = 'Service'; ToolTip = 'Specifies the E-Document Service that retrieved the document.'; } field("Service Integration"; Rec."Service Integration") { Caption = 'Source'; ToolTip = 'Specifies the source of the document.'; } field("Source Details"; Rec."Source Details") { Caption = 'Source Details'; ToolTip = 'Specifies the details about the source of the document.'; } field("Document Type"; Rec."Document Type") { Caption = 'Document Type'; ToolTip = 'Specifies the type of the document.'; StyleExpr = DocumentTypeStyleTxt; } field("Document Record ID"; RecordLinkTxt) { Caption = 'Finalized Document No.'; ToolTip = 'Specifies the entity created from the document.'; trigger OnDrillDown() begin Rec.ShowRecord(); end; } } } area(FactBoxes) { part("Attached Documents List"; "Doc. Attachment List Factbox") { ApplicationArea = All; Caption = 'Documents'; UpdatePropagation = Both; SubPageLink = "Table ID" = const(Database::"E-Document"), "E-Document Entry No." = field("Entry No"), "E-Document Attachment" = const(true); } part(InboundEDocPicture; "Inbound E-Doc. Picture") { Caption = 'Preview'; SubPageLink = "Entry No." = field("Unstructured Data Entry No."), "File Format" = const("E-Doc. File Format"::PDF); ShowFilter = false; Visible = HasPdf; } part(InboundEDocFactbox; "Inbound E-Doc. Factbox") { Caption = 'E-Document Details'; SubPageLink = "E-Document Entry No" = field("Entry No"); ShowFilter = false; } part(EDocMessages; "E-Document Messages FactBox") { Caption = 'Messages'; SubPageLink = "E-Document Entry No." = field("Entry No"); ShowFilter = false; } } } actions { area(Processing) { fileuploadaction(ImportPdf) { Caption = 'Import PDF'; ToolTip = 'Create an electronic document by importing a PDF file.'; AllowedFileExtensions = '.pdf'; AllowMultipleFiles = true; Image = SendAsPDF; Visible = false; trigger OnAction(Files: List of [FileUpload]) begin NewFromPdf(Files); end; } fileuploadaction(ImportXML) { Caption = 'Import XML'; ToolTip = 'Create an electronic document by importing an XML file.'; AllowedFileExtensions = '.xml'; AllowMultipleFiles = true; Image = XMLFile; Visible = true; trigger OnAction(Files: List of [FileUpload]) begin NewFromXml(Files); end; } fileuploadaction(ImportManually) { Caption = 'Import other file'; ToolTip = 'Create an electronic document by manually uploading a file.'; Image = Import; AllowMultipleFiles = true; Visible = false; trigger OnAction(Files: List of [FileUpload]) begin NewFromFile(Files); end; }#if not CLEAN27#pragma warning disable AA0194, AL0432 action(ViewMailMessage) { ApplicationArea = Basic, Suite; Caption = 'View e-mail message'; ToolTip = 'View the source e-mail message.'; Image = Email; Visible = EmailVisibilityFlag; ObsoleteReason = 'Will be removed in future versions'; ObsoleteState = Pending; ObsoleteTag = '27.0'; trigger OnAction() var begin // Temporary solution to keep page not extensible. end; }#pragma warning restore AA0194#endif action(AnalyzeDocument) { ApplicationArea = Basic, Suite; Caption = 'Analyze PDF'; ToolTip = 'Analyze the pdf document with Azure Document Intelligence.'; Image = NewPurchaseInvoice; Visible = false; trigger OnAction() var TempEDocImportParameters: Record "E-Doc. Import Parameters"; EDocImport: Codeunit "E-Doc. Import"; EDocumentErrorHelper: Codeunit "E-Document Error Helper"; begin TempEDocImportParameters."Step to Run" := "Import E-Document Steps"::"Read into Draft"; EDocImport.ProcessIncomingEDocument(Rec, TempEDocImportParameters); EDocumentErrorHelper.ThrowIfHasErrors(Rec); end; } action(PrepareDraftDocument) { ApplicationArea = Basic, Suite; Caption = 'Prepare Draft'; ToolTip = 'Prepare the draft document.'; Image = Process; Visible = false; trigger OnAction() var TempEDocImportParameters: Record "E-Doc. Import Parameters"; EDocImport: Codeunit "E-Doc. Import"; EDocumentErrorHelper: Codeunit "E-Document Error Helper"; ImportEDocumentProcess: Codeunit "Import E-Document Process"; begin TempEDocImportParameters := Rec.GetEDocumentService().GetDefaultImportParameters(); TempEDocImportParameters."Desired E-Document Status" := TempEDocImportParameters."Desired E-Document Status"::"Draft Ready"; EDocImport.ProcessIncomingEDocument(Rec, TempEDocImportParameters); EDocumentErrorHelper.ThrowIfHasErrors(Rec); if ImportEDocumentProcess.IsEDocumentInStateGE(Rec, Enum::"Import E-Doc. Proc. Status"::"Ready for draft") then EDocumentHelper.OpenDraftPage(Rec) end; } action(OpenDraftDocument) { ApplicationArea = Basic, Suite; Caption = 'Open draft document'; ToolTip = 'Process the selected document.'; Image = PurchaseInvoice; Enabled = Rec."Entry No" <> 0; trigger OnAction() var TempEDocImportParameters: Record "E-Doc. Import Parameters"; EDocImport: Codeunit "E-Doc. Import"; EDocumentErrorHelper: Codeunit "E-Document Error Helper"; ImportEDocumentProcess: Codeunit "Import E-Document Process"; begin if ImportEDocumentProcess.IsEDocumentInStateGE(Rec, Enum::"Import E-Doc. Proc. Status"::"Ready for draft") then EDocumentHelper.OpenDraftPage(Rec) else begin TempEDocImportParameters."Step to Run" := "Import E-Document Steps"::"Prepare draft"; EDocImport.ProcessIncomingEDocument(Rec, TempEDocImportParameters); EDocumentErrorHelper.ThrowIfHasErrors(Rec); end; end; } action(EDocumentServices) { RunObject = Page "E-Document Services"; Caption = 'E-Document Services'; ToolTip = 'Opens E-Document Services page.'; Image = Server; } action(EDocumentLogs) { RunObject = Page "E-Document Logs"; Caption = 'E-Document Logs'; ToolTip = 'Opens E-Document Logs page.'; Image = Log; } action(ViewFile) { ApplicationArea = Basic, Suite; Caption = 'View source file'; ToolTip = 'View the source file.'; Image = ViewDetails; trigger OnAction() begin Rec.ViewSourceFile(); end; } action(DownloadFile) { ApplicationArea = Basic, Suite; Caption = 'Download file'; ToolTip = 'Download the source file.'; Image = Download; trigger OnAction() begin Rec.ExportDataStorage(); end; } } area(Promoted) { group(Category_New) { Caption = 'Import'; ShowAs = SplitButton; actionref(Promoted_ImportPdf; ImportPdf) { } actionref(Promoted_ImportXML; ImportXML) { } actionref(Promoted_ImportManually; ImportManually) { } } actionref(Promoted_ViewFile; ViewFile) { }#if not CLEAN27 actionref(Promoted_ViewMailMessage; ViewMailMessage) { ObsoleteReason = 'Will be removed in future versions'; ObsoleteState = Pending; ObsoleteTag = '27.0'; }#endif actionref(Promoted_EDocumentServices; EDocumentServices) { } } } views { view(UnknownDocumentType) { Caption = 'Unknown Document Type'; Filters = where("Document Type" = const("E-Document Type"::None)); } view(Unprocessed) { Caption = 'Purchase Invoices - Unprocessed'; Filters = where("Document Type" = const("E-Document Type"::"Purchase Invoice"), "Import Processing Status" = const("Import E-Doc. Proc. Status"::Unprocessed)); } view(DraftReady) { Caption = 'Purchase Invoices - Draft Ready'; Filters = where("Document Type" = const("E-Document Type"::"Purchase Invoice"), "Import Processing Status" = const("Import E-Doc. Proc. Status"::"Draft Ready")); } view(Processed) { Caption = 'Purchase Invoices - Processed'; Filters = where("Document Type" = const("E-Document Type"::"Purchase Invoice"), "Import Processing Status" = const("Import E-Doc. Proc. Status"::Processed)); } } trigger OnAfterGetRecord() var EDocumentProcessing: Codeunit "E-Document Processing"; begin PopulateSenderName(); RecordLinkTxt := EDocumentProcessing.GetRecordLinkText(Rec); PopulateDocumentNameTxt(); PopulateConfirmedVendorNameTxt(); PopulateTaskInfo(); SetDocumentTypeStyleExpression(); HasPdf := false; if EDocDataStorage.Get(Rec."Unstructured Data Entry No.") then HasPdf := EDocDataStorage."File Format" = Enum::"E-Doc. File Format"::PDF;#if not CLEAN27 SetEmailActionsVisibility();#endif end; local procedure PopulateSenderName() begin case Rec."Document Type" of Rec."Document Type"::"Sales Order": if EDocumentSalesHeader.Get(Rec."Entry No") then SenderNameTxt := EDocumentSalesHeader."Buyer Company Name" else begin Clear(EDocumentSalesHeader); SenderNameTxt := ''; end; Rec."Document Type"::"Purchase Invoice", Rec."Document Type"::"Purchase Credit Memo": if EDocumentPurchaseHeader.Get(Rec."Entry No") then SenderNameTxt := EDocumentPurchaseHeader."Vendor Company Name" else begin Clear(EDocumentPurchaseHeader); SenderNameTxt := ''; end; else begin Clear(EDocumentSalesHeader); Clear(EDocumentPurchaseHeader); SenderNameTxt := ''; end; end; end; local procedure PopulateDocumentNameTxt() var CaptionBuilder: TextBuilder; begin if Rec."File Name" <> '' then CaptionBuilder.Append(Rec."File Name" + ' - ') else CaptionBuilder.Append('Draft document - '); CaptionBuilder.Append(Format(Rec."Entry No")); DocumentNameTxt := CaptionBuilder.ToText(); end; local procedure PopulateConfirmedVendorNameTxt() begin ConfirmedVendorTxt := Rec."Bill-to/Pay-to Name" end; local procedure PopulateTaskInfo() var EnvironmentInformation: Codeunit "Environment Information"; begin Clear(AgentTask); AgentTaskStatus := ''; if not EnvironmentInformation.IsSaaSInfrastructure() then exit; if not AgentTask.ReadPermission() then exit; AgentTask.SetRange("Company Name", CompanyName()); AgentTask.SetRange("External ID", Format(Rec."Entry No")); if AgentTask.FindFirst() and (AgentTask.ID <> 0) then AgentTaskStatus := Format(AgentTask.Status); end; #region File Upload Actions local procedure NewFromFile(Files: List of [FileUpload]) var EDocumentService: Record "E-Document Service"; begin if not ChooseEDocumentService(EDocumentService) then exit; ProcessFilesUploads(EDocumentService, Files, Enum::"E-Doc. File Format"::Unspecified); end; local procedure NewFromPdf(Files: List of [FileUpload]) var EDocumentService: Record "E-Document Service"; begin EDocumentService.GetPDFReaderService(); ProcessFilesUploads(EDocumentService, Files, Enum::"E-Doc. File Format"::PDF); end; local procedure NewFromXml(Files: List of [FileUpload]) var EDocumentService: Record "E-Document Service"; begin if not ChooseEDocumentService(EDocumentService) then exit; ProcessFilesUploads(EDocumentService, Files, Enum::"E-Doc. File Format"::XML); end; internal procedure ProcessFilesUploads(EDocumentService: Record "E-Document Service"; Files: List of [FileUpload]; Type: Enum "E-Doc. File Format") var EDocument: Record "E-Document"; EDocImport: Codeunit "E-Doc. Import"; File: FileUpload; InStream: InStream; OpenDraft, Processed : Boolean; DocumentIndex: Integer; TotalFiles, ProcessedFiles, FailedFiles : Integer; Progress: Dialog; Msg: Label 'Processing documents...\To Import:#1#######\Failed:#2#######\Imported:#3#######', Comment = '#1 Number of to import, #2 Number of failed, #3 = Number of imported'; begin DocumentIndex := 1; if GuiAllowed() then begin TotalFiles := Files.Count(); Progress.Open(Msg, TotalFiles, FailedFiles, ProcessedFiles); Progress.Update(1, TotalFiles); Progress.Update(2, FailedFiles); Progress.Update(3, ProcessedFiles); end; foreach File in Files do begin Clear(EDocument); // Open last document in the list OpenDraft := Files.Count() = DocumentIndex; DocumentIndex += 1; File.CreateInStream(InStream); EDocImport.CreateFromType(EDocument, EDocumentService, Type, File.FileName, InStream); Processed := ProcessEDocument(EDocument, OpenDraft); if GuiAllowed() then begin ProcessedFiles += 1; if not Processed then FailedFiles += 1; Progress.Update(2, FailedFiles); Progress.Update(3, ProcessedFiles); end; end; if GuiAllowed then Progress.Close(); end; #endregion File Upload Actions local procedure ProcessEDocument(var EDocument: Record "E-Document"; OpenDraft: Boolean) Success: Boolean var EDocImport: Codeunit "E-Doc. Import"; begin if not EDocumentHelper.EnsureInboundEDocumentHasService(EDocument) then exit; if not EDocImport.ProcessAutomaticallyIncomingEDocument(EDocument) then exit; EDocument.CalcFields("Import Processing Status"); Success := EDocument."Import Processing Status" = "Import E-Doc. Proc. Status"::"Draft Ready"; if Success and OpenDraft then EDocumentHelper.OpenDraftPage(EDocument); end; local procedure ChooseEDocumentService(var EDocumentService: Record "E-Document Service"): Boolean begin exit(Page.RunModal(Page::"E-Document Services", EDocumentService) = Action::LookupOK); end; local procedure SetDocumentTypeStyleExpression() begin DocumentTypeStyleTxt := 'Standard'; if Rec."Document Type" = Rec."Document Type"::None then DocumentTypeStyleTxt := 'Ambiguous'; end;#if not CLEAN27 local procedure SetEmailActionsVisibility() begin EmailVisibilityFlag := Rec.GetEDocumentService()."Service Integration V2".AsInteger() = 6383; // Outlook Integration end;#endif var EDocDataStorage: Record "E-Doc. Data Storage"; EDocumentPurchaseHeader: Record "E-Document Purchase Header"; EDocumentSalesHeader: Record "E-Document Sales Header"; AgentTask: Record "Agent Task"; EDocumentHelper: Codeunit "E-Document Helper"; RecordLinkTxt, DocumentNameTxt, DocumentTypeStyleTxt, ConfirmedVendorTxt, AgentTaskStatus : Text; SenderNameTxt: Text; HasPdf: Boolean;#if not CLEAN27 EmailVisibilityFlag: Boolean;#endif}