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

package/src/sap/suite/ui/generic/template/lib/MessageUtils.js

@@ -169,6 +169,7 @@ sap.ui.define([
 					sMessageDescription = oResourceBundle.getText("ST_GENERIC_ERROR_SYSTEM_UNAVAILABLE_DESC");
 					break;
 				case 0:
+				case undefined:
 					// case when server being offline
 					/*adapted to have a reasonable processing for the Apply-Button -
 					 * workaround to not leave the page in case of apply */

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

@@ -92,8 +92,11 @@ sap.ui.define([
         },
 
         /**
-         * Sends the user's free-text input to the AI service and returns the structured result.
-         * The AI service is accessed via oTemplateUtils.oServices.oFioriAIHandler.
+         * Sends the user's free-text input to the AI service using a two-prompt flow.
+         *
+         * First prompt sends field metadata without table row data. If the AI returns
+         * 'scnd_cll' (second-call flag), a second prompt is made with the current table
+         * row data (ISLM_Collection_Data) so the AI can reference existing rows.
          *
          * @param {string} sInputText - the user's free-text input from the EasyFill textarea
          * @param {object} mFieldMapping - the complete field mapping built by buildFieldMapping()
@@ -101,19 +104,135 @@ sap.ui.define([
          * @returns {Promise<object>} AI service result: { success: boolean, data: object }
          */
         submitToAI: async function(sInputText, mFieldMapping, oTemplateUtils) {
-            oLogger.debug("submitToAI: sending input to AI service");
+            oLogger.debug("submitToAI: starting two-prompt AI extraction flow");
             try {
-                var aiCallResult = await oTemplateUtils.oServices.oFioriAIHandler.fioriaiLib.EasyFill.extractFieldValuesFromText(
-                    sInputText,
-                    mFieldMapping
-                );
-                return aiCallResult;
+                var oEasyFill = oTemplateUtils.oServices.oFioriAIHandler.fioriaiLib.EasyFill;
+
+                // First prompt: send field metadata without table row data
+                var mFieldMappingWithoutTableRows = this.buildFieldMappingWithoutTableRows(mFieldMapping);
+                var oFirstResult = await oEasyFill.extractFieldValuesFromText(sInputText, mFieldMappingWithoutTableRows);
+                if (!oFirstResult.success) {
+                    return oFirstResult;
+                }
+
+                // If the AI signals that table row context is needed, run a second prompt
+                if ("scnd_cll" in oFirstResult.data) {
+                    oLogger.debug("submitToAI: second prompt required for table row edits");
+                    var oTableData = this.buildTableDataForSecondPrompt(oFirstResult.data, mFieldMapping);
+                    var mFilteredMetadata = this.filterFieldMetadataByFirstPromptResponse(oFirstResult.data, mFieldMapping);
+                    var oSecondResult = await oEasyFill.extractFieldValuesWithTableData(sInputText, mFilteredMetadata, oTableData);
+                    if (!oSecondResult.success) {
+                        return oSecondResult;
+                    }
+                    return { success: true, data: this.stripSecondPromptFlag(oSecondResult.data) };
+                }
+
+                // No second prompt needed: first prompt returned all field values
+                return { success: true, data: this.stripSecondPromptFlag(oFirstResult.data) };
             } catch (e) {
                 oLogger.error("submitToAI: AI call failed: " + (e && e.message));
                 return { success: false, data: {} };
             }
         },
 
+        /**
+         * Returns a copy of mFieldMapping where collection entries contain only
+         * { description, dataType, itemProperties, isCollection: true }, with
+         * currentItems removed. Used for the first AI prompt to avoid sending large
+         * table row payloads before it is known whether the AI needs them.
+         * itemProperties is preserved so the LLM knows the schema of each collection.
+         *
+         * @param {object} mFieldMapping - the complete field mapping
+         * @returns {object} field mapping with currentItems stripped from collection entries
+         */
+        buildFieldMappingWithoutTableRows: function(mFieldMapping) {
+            var mResult = {};
+            Object.keys(mFieldMapping).forEach(function(sFieldName) {
+                var oEntry = mFieldMapping[sFieldName];
+                if (oEntry && oEntry.isCollection === true) {
+                    mResult[sFieldName] = {
+                        description: oEntry.description,
+                        dataType: oEntry.dataType,
+                        itemProperties: oEntry.itemProperties,
+                        isCollection: true
+                    };
+                } else {
+                    mResult[sFieldName] = oEntry;
+                }
+            });
+            return mResult;
+        },
+
+        /**
+         * Builds the table data structure passed to the second AI prompt (ISLM_Collection_Data).
+         * Only includes tables that were mentioned in the first prompt response and have
+         * existing row data.
+         *
+         * @param {object} oFirstPromptData - the first prompt response data (may contain scnd_cll)
+         * @param {object} mFieldMapping - the complete field mapping (contains currentItems per table)
+         * @returns {object} table data: { [navProp]: { currentItems: array } }
+         */
+        buildTableDataForSecondPrompt: function(oFirstPromptData, mFieldMapping) {
+            var oTableData = {};
+            Object.keys(oFirstPromptData).forEach(function(sFieldName) {
+                if (sFieldName === "scnd_cll") { return; }
+                var oFieldMeta = mFieldMapping[sFieldName];
+                if (!oFieldMeta || oFieldMeta.isCollection !== true) { return; }
+                var aCurrentItems = oFieldMeta.currentItems;
+                if (Array.isArray(aCurrentItems) && aCurrentItems.length > 0) {
+                    oTableData[sFieldName] = { currentItems: aCurrentItems };
+                }
+            });
+            return oTableData;
+        },
+
+        /**
+         * Filters the field mapping to only include fields mentioned in the first prompt
+         * response. For collection fields, currentItems is excluded because table data is
+         * passed separately via ISLM_Collection_Data in the second prompt.
+         *
+         * @param {object} oFirstPromptData - the first prompt response data
+         * @param {object} mFieldMapping - the complete field mapping
+         * @returns {object} filtered field metadata for the second prompt
+         */
+        filterFieldMetadataByFirstPromptResponse: function(oFirstPromptData, mFieldMapping) {
+            var mResult = {};
+            Object.keys(oFirstPromptData).forEach(function(sFieldName) {
+                if (sFieldName === "scnd_cll") { return; }
+                var oFieldMeta = mFieldMapping[sFieldName];
+                if (oFieldMeta === undefined) { return; }
+                if (oFieldMeta.isCollection === true) {
+                    // Include collection metadata without currentItems
+                    var oWithoutCurrentItems = {};
+                    Object.keys(oFieldMeta).forEach(function(sKey) {
+                        if (sKey !== "currentItems") {
+                            oWithoutCurrentItems[sKey] = oFieldMeta[sKey];
+                        }
+                    });
+                    mResult[sFieldName] = oWithoutCurrentItems;
+                } else {
+                    mResult[sFieldName] = oFieldMeta;
+                }
+            });
+            return mResult;
+        },
+
+        /**
+         * Returns a copy of oData with the internal 'scnd_cll' flag key removed.
+         *
+         * @param {object} oData - field values that may contain the scnd_cll flag
+         * @returns {object} field values without the internal flag
+         */
+        stripSecondPromptFlag: function(oData) {
+            var oResult = {};
+            Object.keys(oData).forEach(function(sKey) {
+                if (sKey !== "scnd_cll") {
+                    oResult[sKey] = oData[sKey];
+                }
+            });
+            return oResult;
+        },
+
         /**
          * Converts date-like string values in the AI response to JavaScript Date objects,
          * based on the OData data type declared in the field mapping.

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

@@ -8,6 +8,11 @@ sap.ui.define([
     var sClassName = "lib.ai.EasyFill.EasyFillApplyHandler";
     var oLogger = new FeLogger(sClassName).getLogger();
 
+    // Maximum number of characters accepted as AI input.
+    // Keep in sync with EasyFillDialogController.MAX_INPUT_LENGTH and the TextArea maxLength in
+    // EasyFillDialog.fragment.xml.
+    var MAX_INPUT_LENGTH = 50000;
+
     /**
      * EasyFillApplyHandler
      *
@@ -210,7 +215,7 @@ sap.ui.define([
          * Clears the dialog model properties, destroys table preview items,
          * and optionally clears the text area value.
          *
-         * @param {boolean} bRemoveTextAreaValue - if true, also clears the user input text area
+         * @param {boolean} bRemoveTextAreaValue - if true, also clears the user input text area and resets all file import state (sImportedFileText, file model properties)
          * @param {object} oDialogModel - the easyFillDialogModel JSONModel
          * @param {object} oController - MVC controller (used to byId controls)
          * @param {object} mCollectionUpdates - mutable collection updates map (cleared in place)
@@ -260,6 +265,9 @@ sap.ui.define([
                 var oTextArea = oController.byId("EasyFillInputTextArea");
                 if (oTextArea) { oTextArea.setValue(""); }
                 oDialogModel.setProperty("/isEasyFillButtonEnabled", false);
+                oDialogModel.setProperty("/hasEnteredText", false);
+                var oRb = oController.getView().getModel("i18n").getResourceBundle();
+                oDialogModel.setProperty("/remainingCharactersText", oRb.getText("EASYFILL_REMAINING_CHARACTERS", [MAX_INPUT_LENGTH]));
             }
 
             oLogger.debug("resetEasyFill: dialog state reset" + (bRemoveTextAreaValue ? " (including text area)" : ""));

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

@@ -1,14 +1,27 @@
 sap.ui.define([
     "sap/ui/model/json/JSONModel",
     "sap/m/MessageToast",
+    "sap/m/MessageBox",
+    "sap/m/Text",
     "sap/suite/ui/generic/template/genericUtilities/FeLogger",
-    "sap/ui/core/ResizeHandler"
-], function(JSONModel, MessageToast, FeLogger, ResizeHandler) {
+    "sap/ui/core/ResizeHandler",
+    "sap/m/Table",
+    "sap/m/Column",
+    "sap/m/ColumnListItem"
+], function(JSONModel, MessageToast, MessageBox, Text, FeLogger, ResizeHandler, MTable, Column, ColumnListItem) {
     "use strict";
 
     var sClassName = "lib.ai.EasyFill.EasyFillDialogController";
     var oLogger = new FeLogger(sClassName).getLogger();
 
+    // Maximum number of characters accepted as AI input — applies to both the textarea
+    // (fragment maxLength) and imported file text. Keep in sync with EasyFillDialog.fragment.xml
+    // (TextArea maxLength) and EasyFillApplyHandler.
+    var MAX_INPUT_LENGTH = 50000;
+    // Maximum number of CSV data rows rendered in the preview table — guards against building
+    // thousands of controls synchronously. The full text is still sent to the AI.
+    var MAX_PREVIEW_ROWS = 200;
+
     /**
      * EasyFillDialogController
      *
@@ -22,6 +35,29 @@ sap.ui.define([
      * All data operations are delegated to EasyFillAIOrchestrator, EasyFillFormRenderer,
      * EasyFillTableRenderer, and EasyFillApplyHandler.
      */
+    // ─── Private Helpers ─────────────────────────────────────────────────────
+
+    function _addTextPreview(oPreviewContent, sText) {
+        var oText = new Text({ text: sText });
+        oText.addStyleClass("sapSmartTemplatesObjectPageEasyFillFilePreviewText");
+        oPreviewContent.addItem(oText);
+    }
+
+    function _createCSVPreviewTable(oParsed) {
+        var oTable = new MTable({ width: "100%", backgroundDesign: "Solid" });
+        oTable.addStyleClass("sapSmartTemplatesObjectPageEasyFillFilePreviewTable");
+        oParsed.headers.forEach(function(sHeader) {
+            oTable.addColumn(new Column({ width: "10rem", header: new Text({ text: sHeader }) }));
+        });
+        // Cap the number of rendered rows so a large CSV cannot freeze the dialog by creating
+        // one control per cell for thousands of rows.
+        oParsed.rows.slice(0, MAX_PREVIEW_ROWS).forEach(function(aRow) {
+            var aCells = aRow.map(function(sCell) { return new Text({ text: sCell }); });
+            oTable.addItem(new ColumnListItem({ cells: aCells }));
+        });
+        return oTable;
+    }
+
     return {
 
         /**
@@ -66,9 +102,22 @@ sap.ui.define([
                 isFullScreen: true,
                 hasTableUpdates: false,
                 attemptedMultipleNewRows: false,
-                isSplitterPageMode: false
+                isSplitterPageMode: false,
+                // File import state
+                uploadedFileName: "",
+                uploadedFileSize: "",
+                uploadedFileType: "none",
+                filePreviewVisible: false,
+                uploadProgress: 0,
+                selectedFilePreviewMode: "Text",
+                isDragging: false,
+                hasEnteredText: false,
+                remainingCharactersText: ""
             };
 
+            var oRbInit = oController.getView().getModel("i18n").getResourceBundle();
+            oData.remainingCharactersText = oRbInit.getText("EASYFILL_REMAINING_CHARACTERS", [MAX_INPUT_LENGTH]);
+
             oController.getView().setModel(new JSONModel(oData), "easyFillDialogModel");
             oLogger.debug("initDialogModel: easyFillDialogModel created and registered on view");
         },
@@ -118,6 +167,10 @@ sap.ui.define([
 
             if (!oDialog) { return; }  // guard: load rejected, nothing to open
 
+            if (oHandlers._onAfterOpen) {
+                oDialog.attachEventOnce("afterOpen", oHandlers._onAfterOpen);
+            }
+
             oDialog.open();
 
             if (!oDialog._easyFillResizeHandlerId) {
@@ -212,25 +265,193 @@ sap.ui.define([
 
         /**
          * Handles the live change event on the input text area.
-         * Enforces the 2000 character limit by truncating excess input.
          * Enables/disables the "Easy Fill" submit button based on whether there is any input.
          *
          * @param {sap.ui.base.Event} oEvent
          * @param {object} oController - MVC controller
          */
         onLiveChange: function(oEvent, oController) {
-            var oTextArea = oEvent.getSource();
-            var sValue = oTextArea.getValue();
-            var iMaxLength = 2000;
-
-            // Enforce character limit by truncating excess input
-            if (sValue && sValue.length > iMaxLength) {
-                sValue = sValue.substring(0, iMaxLength);
-                oTextArea.setValue(sValue);
+            var sValue = oEvent.getSource().getValue();
+
+            var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+            // Button is enabled when there is text in the textarea OR a file has been imported
+            var bHasFileImported = !!oDialogModel.getProperty("/uploadedFileName") &&
+                oDialogModel.getProperty("/filePreviewVisible");
+            oDialogModel.setProperty("/isEasyFillButtonEnabled", !!sValue || bHasFileImported);
+            oDialogModel.setProperty("/hasEnteredText", !!sValue);
+
+            var oRb = oController.getView().getModel("i18n").getResourceBundle();
+            oDialogModel.setProperty("/remainingCharactersText", oRb.getText("EASYFILL_REMAINING_CHARACTERS", [MAX_INPUT_LENGTH - sValue.length]));
+        },
+
+        // ─── File Import Handlers ──────────────────────────────────────────────────
+
+        /**
+         * Handles the FileUploader change event when a file is selected.
+         * Delegates to the shared acceptFile path.
+         *
+         * @param {sap.ui.base.Event} oEvent - FileUploader change event
+         * @param {object} oController - MVC controller
+         * @param {object} oRb - i18n resource bundle
+         * @param {object} oFileHandler - EasyFillFileHandler module
+         * @param {function} fnOnTextImported - callback(sText) called after successful file read
+         */
+        onFileUploaderChange: function(oEvent, oController, oRb, oFileHandler, fnOnTextImported) {
+            var oFileUploader = oEvent.getSource();
+            var aFiles = oEvent.getParameter("files");
+            var oFile = aFiles && aFiles[0];
+            if (oFile) {
+                this.acceptFile(oController, oRb, oFileHandler, oFile, fnOnTextImported);
+            }
+            oFileUploader.clear();
+        },
+
+        /**
+         * Shows a file-upload error in a MessageBox popup dialog (mirrors V4
+         * EasyFillDialog.showFileUploadError). Used for every file-import failure —
+         * unsupported type, multiple files, empty/unreadable file, and over-limit text.
+         *
+         * @param {object} oRb - i18n resource bundle
+         * @param {string} sMessage - localized error message to display
+         */
+        showFileUploadError: function(oRb, sMessage) {
+            MessageBox.error(sMessage, {
+                title: oRb.getText("EASY_FILL_FILE_UPLOAD_ERROR_TITLE")
+            });
+        },
+
+        /**
+         * Shows the "unsupported file type" error popup. Wired to the FileUploader
+         * typeMissmatch event, which fires when the chosen file's extension is not txt/csv
+         * (the FileUploader rejects it before change fires, so the user otherwise gets no feedback).
+         *
+         * @param {object} oRb - i18n resource bundle
+         */
+        showFileTypeError: function(oRb) {
+            this.showFileUploadError(oRb, oRb.getText("EASY_FILL_UPLOAD_UNSUPPORTED_FILE_ERROR"));
+        },
+
+        /**
+         * Shared file-accept path used by both the FileUploader change handler and the
+         * drag-and-drop handler. Sets the file metadata on the model, reads the file via
+         * EasyFillFileHandler, enforces the input-length cap, and surfaces all failures as a
+         * MessageBox error popup (localized) rather than a transient toast.
+         *
+         * @param {object} oController - MVC controller
+         * @param {object} oRb - i18n resource bundle
+         * @param {object} oFileHandler - EasyFillFileHandler module
+         * @param {File} oFile - the selected/dropped file
+         * @param {function} fnOnTextImported - callback(sText) invoked once the (within-limit) text is read
+         */
+        acceptFile: function(oController, oRb, oFileHandler, oFile, fnOnTextImported) {
+            var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+            var oSelf = this;
+
+            function clearFileMeta() {
+                oDialogModel.setProperty("/uploadedFileName", "");
+                oDialogModel.setProperty("/uploadedFileSize", "");
+                oDialogModel.setProperty("/uploadedFileType", "none");
+                oDialogModel.setProperty("/uploadProgress", 0);
+                oDialogModel.setProperty("/filePreviewVisible", false);
+                oDialogModel.setProperty("/isEasyFillButtonEnabled", false);
             }
 
+            oDialogModel.setProperty("/uploadedFileName", oFile.name);
+            oDialogModel.setProperty("/uploadedFileSize", oFileHandler.formatFileSize(oFile.size));
+            oDialogModel.setProperty("/uploadedFileType", oFileHandler.getFileType(oFile.name));
+            oDialogModel.setProperty("/uploadProgress", 0);
+
+            oFileHandler.importFile(oFile, {
+                onTextImported: function(sText) {
+                    // Enforce the same character cap as the textarea on imported file text.
+                    if (sText.length > MAX_INPUT_LENGTH) {
+                        oLogger.warning("acceptFile: imported text exceeds MAX_INPUT_LENGTH (" + sText.length + ")");
+                        clearFileMeta();
+                        oSelf.showFileUploadError(oRb, oRb.getText("EASY_FILL_UPLOAD_FILE_TOO_LARGE_ERROR", [MAX_INPUT_LENGTH]));
+                        return;
+                    }
+                    var sFileType = oDialogModel.getProperty("/uploadedFileType");
+                    oDialogModel.setProperty("/selectedFilePreviewMode", sFileType === "csv" ? "Table" : "Text");
+                    fnOnTextImported(sText);
+                    oDialogModel.setProperty("/filePreviewVisible", true);
+                    oDialogModel.setProperty("/isEasyFillButtonEnabled", true);
+                    MessageToast.show(oRb.getText("EASY_FILL_FILE_IMPORTED_SUCCESS", [oFile.name]));
+                },
+                onValidationError: function() {
+                    clearFileMeta();
+                    oSelf.showFileUploadError(oRb, oRb.getText("EASY_FILL_UPLOAD_UNSUPPORTED_FILE_ERROR"));
+                },
+                onReadError: function(sReason) {
+                    clearFileMeta();
+                    var sErrorKey = sReason === "empty"
+                        ? "EASY_FILL_UPLOAD_EMPTY_FILE_ERROR"
+                        : "EASY_FILL_UPLOAD_READ_ERROR";
+                    oSelf.showFileUploadError(oRb, oRb.getText(sErrorKey));
+                },
+                onProgress: function(iPercent) {
+                    oDialogModel.setProperty("/uploadProgress", iPercent);
+                }
+            });
+        },
+
+        /**
+         * Renders file preview content into the EasyFillFilePreviewContent VBox.
+         * CSV files in table-preview mode are rendered as a sap.m.Table; all other content
+         * is rendered as a sap.m.Text.
+         *
+         * @param {object} oController - MVC controller
+         * @param {object} oFileHandler - EasyFillFileHandler module (used for parseCSV in table-preview mode)
+         * @param {string|null} sImportedFileText - currently imported file text (or null)
+         */
+        renderFilePreview: function(oController, oFileHandler, sImportedFileText) {
+            var oPreviewContent = oController.byId("EasyFillFilePreviewContent");
+            if (!oPreviewContent) { return; }
+            oPreviewContent.destroyItems();
+
+            var sText = sImportedFileText || "";
+            if (!sText) { return; }
+
+            var oDialogModel = oController.getView().getModel("easyFillDialogModel");
+            var sMode = oDialogModel ? oDialogModel.getProperty("/selectedFilePreviewMode") : "Text";
+            var sFileType = oDialogModel ? oDialogModel.getProperty("/uploadedFileType") : "none";
+
+            if (sMode === "Table" && sFileType === "csv") {
+                var oParsed = oFileHandler.parseCSV(sText);
+                if (oParsed && oParsed.headers.length > 0) {
+                    oPreviewContent.addItem(_createCSVPreviewTable(oParsed));
+                    if (oParsed.rows.length > MAX_PREVIEW_ROWS) {
+                        var oRb = oController.getView().getModel("i18n").getResourceBundle();
+                        var oNote = new Text({ text: oRb.getText("EASY_FILL_FILE_PREVIEW_TRUNCATED", [MAX_PREVIEW_ROWS]) });
+                        oNote.addStyleClass("sapSmartTemplatesObjectPageEasyFillFilePreviewText");
+                        oPreviewContent.addItem(oNote);
+                    }
+                } else {
+                    _addTextPreview(oPreviewContent, sText);
+                }
+            } else {
+                _addTextPreview(oPreviewContent, sText);
+            }
+        },
+
+        /**
+         * Resets all file-related state in the dialog model and clears the preview area.
+         * Called by EasyFillHandler._resetEasyFill when the dialog is cleared or cancelled.
+         *
+         * @param {object} oController - MVC controller
+         */
+        resetFileState: function(oController) {
             var oDialogModel = oController.getView().getModel("easyFillDialogModel");
-            oDialogModel.setProperty("/isEasyFillButtonEnabled", !!sValue);
+            if (!oDialogModel) { return; }
+            oDialogModel.setProperty("/uploadedFileName", "");
+            oDialogModel.setProperty("/uploadedFileSize", "");
+            oDialogModel.setProperty("/uploadedFileType", "none");
+            oDialogModel.setProperty("/filePreviewVisible", false);
+            oDialogModel.setProperty("/uploadProgress", 0);
+            oDialogModel.setProperty("/selectedFilePreviewMode", "Text");
+            oDialogModel.setProperty("/isDragging", false);
+
+            var oPreviewContent = oController.byId("EasyFillFilePreviewContent");
+            if (oPreviewContent) { oPreviewContent.destroyItems(); }
         },
 
         /**