@eclipse-scout/core 11.0.39 → 11.0.41

package/dist/eclipse-scout-core.js

@@ -83785,6 +83785,35 @@ function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.g
  */
 
 
+/**
+ * A lookup call that can load lookup rows from a REST service.
+ *
+ * API:
+ * ----
+ * By default, the REST service is expected to listen for POST requests at the URL defined by
+ * this.resourceUrl. It receives a restriction object and must return a list of matching lookup rows.
+ * The serialization format is JSON.
+ *
+ * Lookup rows:
+ * ------------
+ * The standard lookup row properties defined by Scout are usually sufficient (see AbstractLookupRowDo.java).
+ *
+ * Restriction:
+ * ------------
+ * The restriction object consists of a number of 'well-known' properties (e.g. 'text' in QueryBy.TEXT
+ * mode, see AbstractLookupRestrictionDo.java for details) and additional, service-dependent properties
+ * that can either be predefined in the model or added programmatically at runtime. Since all of those
+ * properties are sent in the same restriction object, some care must be taken to prevent accidental
+ * overwriting of properties.
+ *
+ * Order of precedence (lowest to highest):
+ * 1. Restrictions automatically applied to all clones after their creation in the respective cloneFor method.
+ *    These are: 'active' (ALL, TEXT, REC) and 'maxRowCount' (ALL, TEXT, REC)
+ * 2. Restrictions predefined in the model property 'restriction', shared by all clones.
+ * 3. Restrictions applied to clones programmatically, e.g. during a 'prepareLookupCall' event.
+ * 4. Hard-coded properties that are fundamental to the respective queryBy mode (cannot be overridden).
+ *    These are: 'ids' (KEY, KEYS) and 'text' (TEXT)
+ */
 
 var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
   _inherits(RestLookupCall, _LookupCall);
@@ -83824,6 +83853,19 @@ var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
 
       this._restriction[key] = value;
     }
+    /**
+     * Adds the given key-value pair to 'this._restriction', but only if there is no predefined
+     * value for this key in 'this.restriction'. This prevents unintentional overriding of
+     * user-defined model restrictions.
+     */
+
+  }, {
+    key: "_addRestrictionIfAbsent",
+    value: function _addRestrictionIfAbsent(key, value) {
+      if (!this.restriction || _index__WEBPACK_IMPORTED_MODULE_0__["objects"].isNullOrUndefined(this.restriction[key])) {
+        this.addRestriction(key, value);
+      }
+    }
   }, {
     key: "_getAll",
     value: function _getAll() {
@@ -83852,8 +83894,10 @@ var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
     value: function cloneForAll() {
       var clone = _get(_getPrototypeOf(RestLookupCall.prototype), "cloneForAll", this).call(this);
 
-      clone.addRestriction('active', true);
-      clone.addRestriction('maxRowCount', this.maxRowCount);
+      clone._addRestrictionIfAbsent('active', true);
+
+      clone._addRestrictionIfAbsent('maxRowCount', this.maxRowCount);
+
       return clone;
     }
   }, {
@@ -83861,8 +83905,10 @@ var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
     value: function cloneForText(text) {
       var clone = _get(_getPrototypeOf(RestLookupCall.prototype), "cloneForText", this).call(this, text);
 
-      clone.addRestriction('active', true);
-      clone.addRestriction('maxRowCount', this.maxRowCount);
+      clone._addRestrictionIfAbsent('active', true);
+
+      clone._addRestrictionIfAbsent('maxRowCount', this.maxRowCount);
+
       return clone;
     }
   }, {
@@ -83870,8 +83916,10 @@ var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
     value: function cloneForRec(parentKey) {
       var clone = _get(_getPrototypeOf(RestLookupCall.prototype), "cloneForRec", this).call(this, parentKey);
 
-      clone.addRestriction('active', true);
-      clone.addRestriction('maxRowCount', this.maxRowCount);
+      clone._addRestrictionIfAbsent('active', true);
+
+      clone._addRestrictionIfAbsent('maxRowCount', this.maxRowCount);
+
       return clone;
     }
   }, {
@@ -83970,7 +84018,7 @@ var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
         return value;
       };
 
-      var newRestrictions = {};
+      var resolvedRestriction = {};
       var restriction = jquery__WEBPACK_IMPORTED_MODULE_1___default.a.extend({}, this.restriction, this._restriction);
       Object.keys(restriction).forEach(function (key) {
         var value = restriction[key];
@@ -83985,11 +84033,11 @@ var RestLookupCall = /*#__PURE__*/function (_LookupCall) {
         } // Only add non-null restrictions
 
 
-        if (newValue) {
-          newRestrictions[key] = newValue;
+        if (!_index__WEBPACK_IMPORTED_MODULE_0__["objects"].isNullOrUndefined(newValue)) {
+          resolvedRestriction[key] = newValue;
         }
       });
-      return newRestrictions;
+      return resolvedRestriction;
     }
   }, {
     key: "_createAjaxCall",