@sapui5/sap.suite.ui.generic.template 1.153.0 → 1.154.0

package/src/sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillFileHandler.js

@@ -0,0 +1,218 @@
+sap.ui.define([
+    "sap/base/Log",
+    "sap/m/MessageBox"
+], function(Log, MessageBox) {
+    "use strict";
+
+    var sClassName = "lib.ai.EasyFill.EasyFillFileHandler";
+
+    // Browser-reported MIME types vary wildly across OS/browser combinations for the very same
+    // file (e.g. a .csv is "application/vnd.ms-excel" on Windows+Excel, "application/csv" elsewhere,
+    // or "" when nothing is registered). The file extension is the authoritative gate (findHandler),
+    // so these are the types we additionally treat as "text-like" when a type IS reported.
+    var VENDOR_TEXT_MIME_TYPES = {
+        "application/csv": true,
+        "application/vnd.ms-excel": true
+    };
+    var BINARY_MIME_TYPE = "application/octet-stream";
+
+    var FILE_HANDLERS = [
+        {
+            extensions: [".txt", ".csv"],
+            handle: _handleTextFileImport
+        }
+    ];
+
+    // ─── File Validation ──────────────────────────────────────────────────────
+
+    /**
+     * Decides whether a file whose extension already matched a handler should be accepted
+     * based on its (unreliable) browser-reported MIME type.
+     *
+     * The extension is the authoritative gate, so an absent/binary/vendor type is accepted —
+     * only a type that is explicitly a different, non-text category (e.g. "image/png") is rejected.
+     *
+     * @param {File} oFile
+     * @returns {boolean}
+     */
+    function _isMimeTypeAcceptable(oFile) {
+        var sMimeType = oFile.type;
+        // No type reported, or generic binary — common for .txt/.csv; trust the extension.
+        if (!sMimeType || sMimeType === BINARY_MIME_TYPE) {
+            Log.warning(sClassName + ": file " + oFile.name + " has no/binary MIME type; accepting on extension");
+            return true;
+        }
+        if (sMimeType.indexOf("text/") === 0 || VENDOR_TEXT_MIME_TYPES[sMimeType]) {
+            return true;
+        }
+        Log.warning(sClassName + ": file " + oFile.name + " has non-text MIME type: " + sMimeType);
+        return false;
+    }
+
+    // ─── File Type Handlers ───────────────────────────────────────────────────
+
+    /**
+     * Reads a TXT or CSV file as text and reports progress/result via callbacks.
+     * No user-facing messages are shown here — the caller owns localized feedback.
+     * @param {File} oFile
+     * @param {{ onTextImported: function, onValidationError: function, onReadError: function(string=), onProgress: function }} oCallbacks
+     *   onReadError receives "empty" when the file is empty, "read" on a read failure.
+     */
+    function _handleTextFileImport(oFile, oCallbacks) {
+        if (!_isMimeTypeAcceptable(oFile)) {
+            Log.error(sClassName + ": file validation failed for " + oFile.name);
+            if (oCallbacks.onValidationError) { oCallbacks.onValidationError("invalidType"); }
+            return;
+        }
+
+        var oReader = new FileReader();
+        oReader.onprogress = function(oEvent) {
+            if (oEvent.lengthComputable && oCallbacks.onProgress) {
+                oCallbacks.onProgress(Math.round((oEvent.loaded / oEvent.total) * 100));
+            }
+        };
+        oReader.onload = function(oEvent) {
+            if (oCallbacks.onProgress) { oCallbacks.onProgress(100); }
+            var sText = oEvent.target && oEvent.target.result;
+            if (!sText) {
+                Log.error(sClassName + ": text file is empty");
+                if (oCallbacks.onReadError) { oCallbacks.onReadError("empty"); }
+                return;
+            }
+            Log.info(sClassName + ": text file parsed successfully");
+            oCallbacks.onTextImported(sText);
+        };
+        oReader.onerror = function() {
+            Log.error(sClassName + ": failed to read text file");
+            if (oCallbacks.onReadError) { oCallbacks.onReadError("read"); }
+        };
+        oReader.readAsText(oFile);
+    }
+
+    // ─── Public API ───────────────────────────────────────────────────────────
+
+    return {
+
+        /**
+         * Finds the handler entry for the given file name based on its extension.
+         * @param {string} sFileName
+         * @returns {{ extensions: string[], handle: function } | undefined}
+         */
+        findHandler: function(sFileName) {
+            var sLower = sFileName.toLowerCase();
+            return FILE_HANDLERS.find(function(oHandler) {
+                return oHandler.extensions.some(function(sExt) { return sLower.endsWith(sExt); });
+            });
+        },
+
+        /**
+         * Detects the file type ("csv" or "txt") from the file name.
+         * @param {string} sFileName
+         * @returns {"csv" | "txt" | "none"}
+         */
+        getFileType: function(sFileName) {
+            if (!sFileName) { return "none"; }
+            var sLower = sFileName.toLowerCase();
+            if (sLower.endsWith(".csv")) { return "csv"; }
+            if (sLower.endsWith(".txt")) { return "txt"; }
+            return "none";
+        },
+
+        /**
+         * Shows a confirmation dialog before removing a file.
+         * Calls fnOnConfirm only when the user clicks OK.
+         * @param {string} sConfirmText - i18n message to display
+         * @param {function} fnOnConfirm - callback invoked on confirmation
+         */
+        confirmFileRemoval: function(sConfirmText, fnOnConfirm) {
+            MessageBox.confirm(sConfirmText, {
+                onClose: function(sAction) {
+                    if (sAction === MessageBox.Action.OK) {
+                        fnOnConfirm();
+                    }
+                }
+            });
+        },
+
+        /**
+         * Parses a CSV/TSV text string into { headers: string[], rows: string[][] }.
+         * Auto-detects comma vs. semicolon vs. tab as separator and honours double-quoted
+         * fields (separators inside quotes are literal; "" is an escaped quote).
+         * @param {string} sText
+         * @returns {{ headers: string[], rows: string[][] }}
+         */
+        parseCSV: function(sText) {
+            if (!sText) { return { headers: [], rows: [] }; }
+            var aLines = sText.split(/\r?\n/).filter(function(sLine) { return sLine.trim() !== ""; });
+            if (!aLines.length) { return { headers: [], rows: [] }; }
+
+            // Auto-detect separator: tab > semicolon > comma
+            var sSep = ",";
+            var sFirst = aLines[0];
+            if (sFirst.indexOf("\t") !== -1) {
+                sSep = "\t";
+            } else if (sFirst.indexOf(";") !== -1) {
+                sSep = ";";
+            }
+
+            // Quote-aware single-line splitter: a separator inside double quotes is part of the
+            // field, and a doubled quote ("") inside a quoted field is a literal quote.
+            function splitLine(sLine) {
+                var aFields = [];
+                var sField = "";
+                var bInQuotes = false;
+                for (var i = 0; i < sLine.length; i++) {
+                    var c = sLine.charAt(i);
+                    if (c === '"') {
+                        if (bInQuotes && sLine.charAt(i + 1) === '"') {
+                            sField += '"';
+                            i++; // skip the escaped quote
+                        } else {
+                            bInQuotes = !bInQuotes;
+                        }
+                    } else if (c === sSep && !bInQuotes) {
+                        aFields.push(sField.trim());
+                        sField = "";
+                    } else {
+                        sField += c;
+                    }
+                }
+                aFields.push(sField.trim());
+                return aFields;
+            }
+
+            var aHeaders = splitLine(aLines[0]);
+            var aRows = aLines.slice(1).map(splitLine);
+            return { headers: aHeaders, rows: aRows };
+        },
+
+        /**
+         * Formats a byte size into a human-readable string (e.g. "1.2 KB").
+         * @param {number} iBytes
+         * @returns {string}
+         */
+        formatFileSize: function(iBytes) {
+            if (!iBytes || iBytes < 0) { return "0 B"; }
+            if (iBytes < 1024) { return iBytes + " B"; }
+            if (iBytes < 1024 * 1024) { return (iBytes / 1024).toFixed(1) + " KB"; }
+            return (iBytes / (1024 * 1024)).toFixed(1) + " MB";
+        },
+
+        /**
+         * Entry point: validates the file and runs the appropriate handler.
+         * Reports failures via oCallbacks.onValidationError (no user-facing message is shown here —
+         * the caller owns localized feedback).
+         * @param {File} oFile
+         * @param {{ onTextImported: function, onValidationError: function, onReadError: function, onProgress: function }} oCallbacks
+         */
+        importFile: function(oFile, oCallbacks) {
+            var oHandler = this.findHandler(oFile.name);
+            if (!oHandler) {
+                Log.error(sClassName + ": unsupported file type: " + oFile.name);
+                if (oCallbacks.onValidationError) { oCallbacks.onValidationError("unsupported"); }
+                return;
+            }
+            oHandler.handle(oFile, oCallbacks);
+        }
+    };
+});

package/src/sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillFormRenderer.js

@@ -184,7 +184,8 @@ sap.ui.define([
                     // "Original Value:" text shown for all fields (editable and non-editable)
                     var oOriginalValueText = new Text({
                         text: sOriginalValueLabel + " " + sCurrentValue,
-                        wrapping: false
+                        wrapping: false,
+                        tooltip: sOriginalValueLabel + " " + sCurrentValue
                     }).addStyleClass("sapEasyFillPreviouslyLabel");
                     oGroupElement.addElement(oOriginalValueText);
 
@@ -214,7 +215,10 @@ sap.ui.define([
                             text: sProposedValueLabel + " " + sAIDisplayValue,
                             wrapping: false,
                             visible: false,
-                            icon: "sap-icon://ai"
+                            icon: "sap-icon://ai",
+                            width: "100%",
+                            tooltip: sProposedValueLabel + " " + sAIDisplayValue,
+                            layoutData: new ColumnElementData({ cellsSmall: 12, cellsLarge: 12 })
                         }).addStyleClass("sapEasyFillProposedValueLink");
 
                         // Revert button: State 1 → State 2

package/src/sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillHandler.js

@@ -8,7 +8,8 @@ sap.ui.define([
     "sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillFormRenderer",
     "sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillTableRenderer",
     "sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillApplyHandler",
-    "sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillDialogController"
+    "sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillDialogController",
+    "sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillFileHandler"
 ], function(
     BaseObject,
     extend,
@@ -19,7 +20,8 @@ sap.ui.define([
     EasyFillFormRenderer,
     EasyFillTableRenderer,
     EasyFillApplyHandler,
-    EasyFillDialogController
+    EasyFillDialogController,
+    EasyFillFileHandler
 ) {
     "use strict";
 
@@ -60,6 +62,9 @@ sap.ui.define([
         // including extension fragment fields and custom fields.
         var oOPStructureMap = null;
         var mLiveEditable = null;
+        // Stores the text extracted from an imported file (TXT/CSV).
+        // When non-null, this is sent to the AI instead of the textarea value.
+        var sImportedFileText = null;
 
         // Collection state — tracks OData row contexts and property metadata for SmartTable collections
         var mCollectionState = {
@@ -110,6 +115,13 @@ sap.ui.define([
          * @returns {object} handler/formatter map
          */
         function _buildDialogHandlers() {
+            // Shared text-imported callback: sets sImportedFileText and re-renders preview.
+            // Used by both the FileUploader change handler and the drop handler.
+            function fnOnTextImported(sText) {
+                sImportedFileText = sText;
+                EasyFillDialogController.renderFilePreview(oController, EasyFillFileHandler, sImportedFileText);
+            }
+
             return {
                 // ── Layout mode toggle (Condensed ↔ ObjectPage view) ──────────────
                 // After the sections binding is refreshed, SmartForms for the new mode
@@ -221,6 +233,145 @@ sap.ui.define([
                 // ── AI Notice popover ─────────────────────────────────────────────
                 onLinkPress: async function(oEvent) {
                     await EasyFillDialogController.onLinkPress(oEvent, oTemplateUtils, oAIPopoverRef);
+                },
+
+                // ── File import: FileUploader change event ────────────────────────
+                onFileUploaderChange: function(oEvent) {
+                    EasyFillDialogController.onFileUploaderChange(
+                        oEvent, oController, oRb, EasyFillFileHandler, fnOnTextImported
+                    );
+                },
+
+                // ── File import: FileUploader rejected the chosen file by extension ──
+                onFileTypeMismatch: function() {
+                    EasyFillDialogController.showFileTypeError(oRb);
+                },
+
+                // ── File discard: removes the imported file and restores the input area ──
+                onDiscardImportedFile: function() {
+                    EasyFillFileHandler.confirmFileRemoval(oRb.getText("EASY_FILL_REMOVE_FILE_CONFIRM"), function() {
+                        sImportedFileText = null;
+                        EasyFillDialogController.resetFileState(oController);
+                        var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+                        if (oDialogModel) {
+                            oDialogModel.setProperty("/isEasyFillButtonEnabled", false);
+                        }
+                    });
+                },
+
+                // ── Table/text view toggle for CSV preview ───────────────────────────
+                onFilePreviewModeChange: function(oEvent) {
+                    var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+                    var sSelectedKey = oEvent.getParameter("item").getKey();
+                    oDialogModel.setProperty("/selectedFilePreviewMode", sSelectedKey);
+                    EasyFillDialogController.renderFilePreview(oController, EasyFillFileHandler, sImportedFileText);
+                },
+
+                // ── Drag-and-drop: wire native drop events after dialog opens ────────
+                // Uses addEventDelegate({onAfterRendering}) on the SAPUI5 control so that
+                // drop handlers are re-attached each time the DOM element is re-created.
+                // This is necessary because EasyFillInputContainer is hidden (visible=false)
+                // when a file is uploaded and shown again on Clear All, which destroys and
+                // recreates the DOM element — exactly the V4 approach.
+                _onAfterOpen: function() {
+                    var oInputContainer = oController.byId("EasyFillInputContainer");
+                    if (!oInputContainer) { return; }
+
+                    function attachDropHandlers() {
+                        var oDomRef = oInputContainer.getDomRef();
+                        if (!oDomRef || oDomRef.dataset["dropInitialized"]) { return; }
+                        oDomRef.dataset["dropInitialized"] = "true";
+
+                        var iDragDepth = 0;
+
+                        function isFileDrag(oDragEvent) {
+                            var oTransfer = oDragEvent.dataTransfer;
+                            return !!(oTransfer && Array.prototype.indexOf.call(oTransfer.types, "Files") !== -1);
+                        }
+
+                        function resetDragState() {
+                            iDragDepth = 0;
+                            oDomRef.classList.remove("sapSmartTemplatesObjectPageEasyFillInputContainerDropDisabled");
+                            oController.getView().getModel("easyFillDialogModel").setProperty("/isDragging", false);
+                        }
+
+                        oDomRef.addEventListener("dragenter", function(oDragEvent) {
+                            if (!isFileDrag(oDragEvent)) { return; }
+                            oDragEvent.preventDefault();
+                            iDragDepth++;
+                        });
+
+                        oDomRef.addEventListener("dragover", function(oDragEvent) {
+                            if (!isFileDrag(oDragEvent)) { return; }
+                            oDragEvent.preventDefault();
+                            var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+                            var bBlocked = !!oDialogModel.getProperty("/uploadedFileName") ||
+                                           !!oDialogModel.getProperty("/hasEnteredText");
+                            if (oDragEvent.dataTransfer) {
+                                oDragEvent.dataTransfer.dropEffect = bBlocked ? "none" : "copy";
+                            }
+                            if (bBlocked) {
+                                oDomRef.classList.add("sapSmartTemplatesObjectPageEasyFillInputContainerDropDisabled");
+                            } else {
+                                oDomRef.classList.remove("sapSmartTemplatesObjectPageEasyFillInputContainerDropDisabled");
+                            }
+                            oDialogModel.setProperty("/isDragging", true);
+                        });
+
+                        oDomRef.addEventListener("dragleave", function(oDragEvent) {
+                            if (!isFileDrag(oDragEvent)) { return; }
+                            iDragDepth = Math.max(0, iDragDepth - 1);
+                            if (iDragDepth === 0) {
+                                oDomRef.classList.remove("sapSmartTemplatesObjectPageEasyFillInputContainerDropDisabled");
+                                oController.getView().getModel("easyFillDialogModel").setProperty("/isDragging", false);
+                            }
+                        });
+
+                        oDomRef.addEventListener("drop", function(oDragEvent) {
+                            oDragEvent.preventDefault();
+                            oDragEvent.stopPropagation();
+                            resetDragState();
+
+                            var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+                            if (oDialogModel.getProperty("/uploadedFileName") ||
+                                oDialogModel.getProperty("/hasEnteredText")) { return; }
+
+                            var oTransfer = oDragEvent.dataTransfer;
+                            var aDropped = oTransfer && oTransfer.files
+                                ? Array.prototype.slice.call(oTransfer.files) : [];
+                            if (aDropped.length === 0) { return; }
+
+                            var aSupported = aDropped.filter(function(oFile) {
+                                return !!EasyFillFileHandler.findHandler(oFile.name);
+                            });
+
+                            if (aSupported.length === 0) {
+                                EasyFillDialogController.showFileUploadError(oRb,
+                                    oRb.getText("EASY_FILL_UPLOAD_UNSUPPORTED_FILE_ERROR"));
+                                return;
+                            }
+                            if (aSupported.length > 1) {
+                                EasyFillDialogController.showFileUploadError(oRb,
+                                    oRb.getText("EASY_FILL_UPLOAD_SINGLE_FILE_ONLY_ERROR"));
+                                return;
+                            }
+
+                            var oFile = aSupported[0];
+                            // Shared accept path: metadata-set + read + length cap + persistent error feedback.
+                            EasyFillDialogController.acceptFile(oController, oRb, EasyFillFileHandler, oFile, fnOnTextImported);
+                        });
+                    }
+
+                    // Add the onAfterRendering delegate once per container instance. The dialog is
+                    // kept alive across opens (keepAlive), so a fresh delegate on every open would
+                    // accumulate; the flag below ensures a single registration. attachDropHandlers()
+                    // itself is idempotent via the dataset guard and re-binds after DOM re-creation.
+                    if (!oInputContainer._easyFillDropDelegateAdded) {
+                        oInputContainer.addEventDelegate({ onAfterRendering: attachDropHandlers });
+                        oInputContainer._easyFillDropDelegateAdded = true;
+                    }
+                    // Attach immediately for the current render (dialog is already open)
+                    attachDropHandlers();
                 }
             };
         }
@@ -264,9 +415,10 @@ sap.ui.define([
                 oObjectPageContext, EasyFillFieldCollector, mCollectionState
             );
 
-            // Submit to AI
+            // Submit to AI — prefer imported file text over the textarea value
+            var sUserInput = sImportedFileText || oController.byId("EasyFillInputTextArea").getValue();
             var aiCallResult = await EasyFillAIOrchestrator.submitToAI(
-                oController.byId("EasyFillInputTextArea").getValue(),
+                sUserInput,
                 mFieldMapping,
                 oTemplateUtils
             );
@@ -519,7 +671,7 @@ sap.ui.define([
          * Resets the EasyFill dialog to its initial state.
          * Delegates to EasyFillApplyHandler.resetEasyFill with the current state references.
          *
-         * @param {boolean} [bRemoveTextAreaValue=false] - if true, also clears the text area input
+         * @param {boolean} [bRemoveTextAreaValue=false] - if true, also clears the text area input and resets all file import state (sImportedFileText, file model properties)
          */
         function _resetEasyFill(bRemoveTextAreaValue) {
             mLastFieldMapping = null;
@@ -541,6 +693,11 @@ sap.ui.define([
                     oTransientContextForEasyFill = null;
                 }
             );
+            // Clear file import state on Clear All / Cancel
+            if (bRemoveTextAreaValue) {
+                sImportedFileText = null;
+                EasyFillDialogController.resetFileState(oController);
+            }
         }
 
         /**