iotagent-node-lib 2.24.0 → 2.26.0

package/.github/workflows/ci.yml

@@ -14,10 +14,10 @@ jobs:
     steps:
       - name: Git checkout
         uses: actions/checkout@v2
-      - name: Use Node.js 12.x
+      - name: Use Node.js 16.x
         uses: actions/setup-node@v1
         with:
-          node-version: 12.x
+          node-version: 16.x
       - name: Run Remark Markdown Linter
         run: |
           npm install
@@ -31,10 +31,10 @@ jobs:
     steps:
       - name: Git checkout
         uses: actions/checkout@v2
-      - name: Use Node.js 12.x
+      - name: Use Node.js 16.x
         uses: actions/setup-node@v1
         with:
-          node-version: 12.x
+          node-version: 16.x
       - name: Run EsLint Node.js Linter
         run: |
           npm install
@@ -51,7 +51,6 @@ jobs:
     strategy:
       matrix:
         node-version:
-          - 12.x
           - 14.x
           - 16.x
     steps:
@@ -78,10 +77,10 @@ jobs:
     steps:
       - name: Git checkout
         uses: actions/checkout@v2
-      - name: 'Test Coverage with Node.js 12.x'
+      - name: 'Test Coverage with Node.js 16.x'
         uses: actions/setup-node@v1
         with:
-          node-version: 12.x
+          node-version: 16.x
       - run: |
           npm install
           npm run test:coverage

package/config.js

@@ -29,7 +29,12 @@ var config = {
     },
     server: {
         port: 4041,
-        host: '0.0.0.0'
+        host: '0.0.0.0',
+        ldSupport : {
+           null: true,
+           datasetId: true,
+           merge: false
+       }
     },
     authentication: {
         enabled: true,

package/doc/advanced-topics.md

@@ -8,6 +8,7 @@
 -   [Autoprovision configuration (autoprovision)](#autoprovision-configuration-autoprovision)
 -   [Explicitly defined attributes (explicitAttrs)](#explicitly-defined-attributes-explicitattrs)
 -   [Configuring operation to persist the data in Context Broker (appendMode)](#configuring-operation-to-persist-the-data-in-context-broker-appendmode)
+-   [Differences between `autoprovision`, `explicitAttrs` and `appendMode`](#differences-between-autoprovision-explicitattrs-and-appendmode)
 -   [Data mapping plugins](#data-mapping-plugins)
     -   [Development](#development)
     -   [Provided plugins](#provided-plugins)
@@ -20,7 +21,6 @@
         -   [Bidirectionality plugin (bidirectional)](#bidirectionality-plugin-bidirectional)
     -   [Autoprovision configuration (autoprovision)](#autoprovision-configuration-autoprovision)
     -   [Explicitly defined attributes (explicitAttrs)](#explicitly-defined-attributes-explicitattrs)
-    -   [Configuring operation to persist the data in Context Broker (appendMode)](#configuring-operation-to-persist-the-data-in-context-broker-appendmode)
 
 ### Secured access to the Context Broker
 
@@ -368,6 +368,28 @@ This is a flag that can be enabled by activating the parameter `appendMode` in t
 activated, the update requests to the Context Broker will be performed always with APPEND type, instead of the default
 UPDATE. This have implications in the use of attributes with Context Providers, so this flag should be used with care.
 
+### Differences between `autoprovision`, `explicitAttrs` and `appendMode`
+
+Since those configuration parameters are quite similar, this section is intended to clarify the relation between them. 
+
+If `autoprovision` is set to `true` (default case), the agent will perform an initial request creating a new entity into 
+the Context Broker with **only** the static and active attributes provisioned in the config group, and also a new
+Device in the agent, every time a measure arrives with a new `device_id`. Otherwise, this measure is ignored. This is 
+something related to the **southbound**.
+
+What `explicitAttrs` does is to filter from the southbound the parameters that are not explicitly defined in the device 
+provision or config group. That also would avoid propagating the measures to the Context Broker.
+
+The default way the agent updates the information into the Context Broker is by using an update request. If 
+`appendMode=true`, the IoTA will use an append request instead of an update one. This means it will store 
+the attributes even if they are not present in the entity. This seems the same functionality that the one provided by
+`autoprovision`, but it is a different concept since the scope of this config is to setup how the IoT interacts with the
+context broker, this is something related to the **northbound**.
+
+Note that, even creating a group with `autoprovision=true` and `explicitAttrs=true`, if you do not provision previously 
+the entity in the Context Broker (having all attributes to be updated), it would fail if `appendMode=false`. For further 
+information check the issue [#1301](https://github.com/telefonicaid/iotagent-node-lib/issues/1301).
+
 ### Data mapping plugins
 
 The IoT Agent Library provides a plugin mechanism in order to facilitate reusing code that makes small transformations

package/doc/apiary/iotagent.apib

@@ -80,7 +80,7 @@ Fields in JSON object representing a configuration group are:
 |:-----------------------|:------------------------------------------------------------|
 |`apikey`                |It is a key used for devices belonging to this service. If "", service does not use apikey, but it must be specified.|
 |`token`                 |If authentication/authorization system is configured, IoT Agent works as user when it publishes information. That token allows that other components to verify the identity of IoT Agent. Depends on authentication and authorization system.|
-|`cbroker`               |Context Broker endpoint assigned to this service, it must be a real uri.|
+|`cbHost`                |Context Broker endpoint assigned to this service, it must be a real uri.|
 |`outgoing_route`        |It is an identifier for VPN/GRE tunnel. It is used when device is into a VPN and a command is sent.|
 |`resource`              |Path in IoTAgent. When protocol is HTTP a device could send information to this uri. In general, it is a uri in a HTTP server needed to load and execute a module.|
 |`entity_type`           |Entity type used in entity publication (overload default).|
@@ -126,7 +126,7 @@ Retrieve a configuration group.
                     "service": "service2",
                     "service_path": "/srvpath2",
                     "token": "token2",
-                    "cbroker": "http://127.0.0.1:1026",
+                    "cbHost": "http://127.0.0.1:1026",
                     "entity_type": "thing",
                     "resource": "/iot/d"
                 }
@@ -152,7 +152,7 @@ Retrieve a configuration group.
                     "service": "service2",
                     "service_path": "/srvpath2",
                     "token": "token2",
-                    "cbroker": "http://127.0.0.1:1026",
+                    "cbHost": "http://127.0.0.1:1026",
                     "entity_type": "thing",
                     "resource": "/iot/d"
                 }
@@ -162,7 +162,7 @@ Retrieve a configuration group.
 
 ### Create a configuration group [POST]
 
-Create a new configuration group. From service model, mandatory fields are: apikey, resource (cbroker field is temporary mandatory).
+Create a new configuration group. From service model, mandatory fields are: apikey, resource (cbHost field is temporary mandatory).
 
 + Request (application/json)
 
@@ -178,7 +178,7 @@ Create a new configuration group. From service model, mandatory fields are: apik
                 {
                   "apikey": "apikey3",
                   "token": "token2",
-                  "cbroker": "http://127.0.0.1:1026",
+                  "cbHost": "http://127.0.0.1:1026",
                   "entity_type": "thing",
                   "resource": "/iot/d"
                 }

package/doc/deprecated.md

@@ -12,13 +12,17 @@ longer. In particular:
 
 A list of deprecated features and the version in which they were deprecated follows:
 
--   Support to NGSI v1.
+-   Support to NGSI v1 (finally removed in 2.18.0)
 -   Support to Node.js v4 in iotagent-node-lib 2.8.1 (finally removed in 2.9.0)
 -   Support to Node.js v6 in iotagent-node-lib 2.9.0 (finally removed in 2.10.0)
 -   Support to Node.js v8 in iotagent-node-lib 2.12.0 (finally removed in 2.13.0)
 -   Support to Node.js v10 in iotagent-node-lib 2.15.0 (finally removed in 2.16.0)
+-   Support to Node.js v12 in iotagent-node-lib 2.24.0 (finally removed in 2.25.0)
+-   Support to NGSI-LD v1.3 in iotagent-node-lib 2.25.0 (finally removed in 2.26.0)
+-   Support groups (provision) statically defined by configuration
+-   Support to in-memory registry (i.e.`deviceRegistry.type=memory`)
 
-The use of Node.js v12 is highly recommended.
+The use of Node.js v14 is highly recommended.
 
 ## Using old iotagent-node-lib versions
 
@@ -38,8 +42,10 @@ The following table provides information about the last iotagent-node-lib versio
 
 | **Removed feature**    | **Last iotagent-node-lib version supporting feature** | **That version release date** |
 | ---------------------- | ----------------------------------------------------- | ----------------------------- |
-| NGSI v1 API            | Not yet defined                                       | Not yet defined               |
-| Support to Node.js v4  | 2.8.1                                                 | December 19th, 2018                 |
-| Support to Node.js v6  | 2.9.0                                                 | May 22nd, 2019                      |
-| Support to Node.js v8  | 2.12.0                                                | April 7th, 2020                    |
-| Support to Node.js v10 | 2.15.0   | February 18th, 2021                |
+| NGSI v1 API            | 2.17.0                                                | August 30th, 2021             |
+| Support to Node.js v4  | 2.8.1                                                 | December 19th, 2018           |
+| Support to Node.js v6  | 2.9.0                                                 | May 22nd, 2019                |
+| Support to Node.js v8  | 2.12.0                                                | April 7th, 2020               |
+| Support to Node.js v10 | 2.15.0                                                | February 18th, 2021           |
+| Support to Node.js v12 | 2.24.0                                                | September 2nd, 2022           |
+| Support to NGSI-LD 1.3 | 2.25.0                                                | January 24th, 2023          |

package/doc/expressionLanguage.md

@@ -75,7 +75,7 @@ can check the following example:
     "services": [
         {
             "apikey": "801230BJKL23Y9090DSFL123HJK09H324HV8732",
-            "cbroker": "http://orion:1026",
+            "cbHost": "http://orion:1026",
             "entity_type": "Thing",
             "resource":    "/iot/d"
             "expressionLanguage": "jexl",
@@ -459,39 +459,49 @@ to incorporate new transformations from the IoT Agent configuration file in a fa
 
 Current common transformation set:
 
-| JEXL Transformation              | Equivalent JavaScript Function                                                                                          |
-| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| jsonparse: (str)                 | `JSON.parse(str);`                                                                                                      |
-| jsonstringify: (obj)             | `JSON.stringify(obj);`                                                                                                  |
-| indexOf: (val, char)             | `String(val).indexOf(char);`                                                                                            |
-| length: (val)                    | `String(val).length;`                                                                                                   |
-| trim: (val)                      | `String(val).trim();`                                                                                                   |
-| substr: (val, int1, int2)        | `String(val).substr(int1, int2);`                                                                                       |
-| addreduce: (arr)                 | <code>arr.reduce((i, v) &vert; i + v));</code>                                                                          |
-| lengtharray: (arr)               | `arr.length;`                                                                                                           |
-| typeof: (val)                    | `typeof val;`                                                                                                           |
-| isarray: (arr)                   | `Array.isArray(arr);`                                                                                                   |
-| isnan: (val)                     | `isNaN(val);`                                                                                                           |
-| parseint: (val)                  | `parseInt(val);`                                                                                                        |
-| parsefloat: (val)                | `parseFloat(val);`                                                                                                      |
-| toisodate: (val)                 | `new Date(val).toISOString();`                                                                                          |
-| timeoffset:(isostr)              | `new Date(isostr).getTimezoneOffset();`                                                                                 |
-| tostring: (val)                  | `val.toString();`                                                                                                       |
-| urlencode: (val)                 | `encodeURI(val);`                                                                                                       |
-| urldecode: (val)                 | `decodeURI(val);`                                                                                                       |
-| replacestr: (str, from, to)      | `str.replace(from, to);`                                                                                                |
-| replaceregexp: (str, reg, to)    | `str.replace(new RegExp(reg), to);`                                                                                     |
-| replaceallstr: (str, from, to)   | `str.replaceAll(from, to);`                                                                                             |
-| replaceallregexp: (str, reg, to) | `str.replaceAll(new RegExp(reg,"g"), to);`                                                                              |
-| split: (str, ch)                 | `str.split(ch);`                                                                                                        |
-| mapper: (val, values, choices)   | <code>choices[values.findIndex((target) &vert; target == val)]);</code>                                                 |
-| thmapper: (val, values, choices) | <code>choices[values.reduce((acc,curr,i,arr) &vert; (acc==0)&vert;&vert;acc?acc:val<=curr?acc=i:acc=null,null)];</code> |
-| bitwisemask: (i,mask,op,shf)     | <code>(op==="&"?parseInt(i)&mask: op==="&vert;"?parseInt(i)&vert;mask: op==="^"?parseInt(i)^mask:i)>>shf;</code>        |
-| slice: (arr, init, end)          | `arr.slice(init,end);`                                                                                                  |
-| addset: (arr, x)                 | <code>{ return Array.from((new Set(arr)).add(x)) }</code>                                                               |
-| removeset: (arr, x)              | <code>{ let s = new Set(arr); s.delete(x); return Array.from(s) }</code>                                                |
-| touppercase: (val)               | `String(val).toUpperCase()`                                                                                             |
-| tolowercase: (val)               | `String(val).toLowerCase()`                                                                                             |
+| JEXL Transformation                  | Equivalent JavaScript Function                                                                                          |
+| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| jsonparse: (str)                     | `JSON.parse(str);`                                                                                                      |
+| jsonstringify: (obj)                 | `JSON.stringify(obj);`                                                                                                  |
+| indexOf: (val, char)                 | `String(val).indexOf(char);`                                                                                            |
+| length: (val)                        | `String(val).length;`                                                                                                   |
+| trim: (val)                          | `String(val).trim();`                                                                                                   |
+| substr: (val, int1, int2)            | `String(val).substr(int1, int2);`                                                                                       |
+| addreduce: (arr)                     | <code>arr.reduce((i, v) &vert; i + v));</code>                                                                          |
+| lengtharray: (arr)                   | `arr.length;`                                                                                                           |
+| typeof: (val)                        | `typeof val;`                                                                                                           |
+| isarray: (arr)                       | `Array.isArray(arr);`                                                                                                   |
+| isnan: (val)                         | `isNaN(val);`                                                                                                           |
+| parseint: (val)                      | `parseInt(val);`                                                                                                        |
+| parsefloat: (val)                    | `parseFloat(val);`                                                                                                      |
+| toisodate: (val)                     | `new Date(val).toISOString();`                                                                                          |
+| timeoffset:(isostr)                  | `new Date(isostr).getTimezoneOffset();`                                                                                 |
+| tostring: (val)                      | `val.toString();`                                                                                                       |
+| urlencode: (val)                     | `encodeURI(val);`                                                                                                       |
+| urldecode: (val)                     | `decodeURI(val);`                                                                                                       |
+| replacestr: (str, from, to)          | `str.replace(from, to);`                                                                                                |
+| replaceregexp: (str, reg, to)        | `str.replace(new RegExp(reg), to);`                                                                                     |
+| replaceallstr: (str, from, to)       | `str.replaceAll(from, to);`                                                                                             |
+| replaceallregexp: (str, reg, to)     | `str.replaceAll(new RegExp(reg,"g"), to);`                                                                              |
+| split: (str, ch)                     | `str.split(ch);`                                                                                                        |
+| joinarrtostr: (arr, ch)              | `arr.join(ch);`                                                                                                         |
+| concatarr: (arr, arr2)               | `arr.concat(arr2);`                                                                                                     |
+| mapper: (val, values, choices)       | <code>choices[values.findIndex((target) &vert; target == val)]);</code>                                                 |
+| thmapper: (val, values, choices)     | <code>choices[values.reduce((acc,curr,i,arr) &vert; (acc==0)&vert;&vert;acc?acc:val<=curr?acc=i:acc=null,null)];</code> |
+| bitwisemask: (i,mask,op,shf)         | <code>(op==="&"?parseInt(i)&mask: op==="&vert;"?parseInt(i)&vert;mask: op==="^"?parseInt(i)^mask:i)>>shf;</code>        |
+| slice: (arr, init, end)              | `arr.slice(init,end);`                                                                                                  |
+| addset: (arr, x)                     | <code>{ return Array.from((new Set(arr)).add(x)) }</code>                                                               |
+| removeset: (arr, x)                  | <code>{ let s = new Set(arr); s.delete(x); return Array.from(s) }</code>                                                |
+| touppercase: (val)                   | `String(val).toUpperCase()`                                                                                             |
+| tolowercase: (val)                   | `String(val).toLowerCase()`                                                                                             |
+| round: (val)                         | `Math.round(val)`                                                                                                       |
+| floor: (val)                         | `Math.floor(val)`                                                                                                       |
+| ceil: (val)                          | `Math.ceil(val)`                                                                                                        |
+| tofixed: (val, decimals)             | `Number.parseFloat(val).toFixed(decimals)`                                                                              |
+| gettime: (d)                         | `new Date(d).getTime()`                                                                                                 |
+| toisostring: (d)                     | `new Date(d).toISOString()`                                                                                             |
+| localestring: (d, timezone, options) | `new Date(d).toLocaleString(timezone, options)`                                                                         |
+| now: ()                              | `Date.now()`                                                                                                            |
 
 You have available this [JEXL interactive playground][99] with all the transformations already loaded, in which you can
 test all the functions described above.

package/doc/getting-started.md

@@ -56,7 +56,7 @@ curl -iX POST \
  "services": [
    {
      "apikey":      "4jggokgpepnvsb2uv4s40d59ov",
-     "cbroker":     "http://orion:1026",
+     "cbHost":     "http://orion:1026",
      "entity_type": "Device",
      "resource":    "/iot/d",
    }

package/doc/howto.md

@@ -430,6 +430,14 @@ iotAgentLib.setDataUpdateHandler(updateContextHandler);
 iotAgentLib.setDataQueryHandler(queryContextHandler);
 ```
 
+Where necessary, additional handlers to deal with command actuations and merge-patch operations may also be added when
+necessary.
+
+```javascript
+iotAgentLib.setCommandHandler(commandHandler);
+iotAgentLib.setMergePatchHandler(mergePatchHandler);
+```
+
 #### IOTA Testing
 
 In order to test it, we need to create an HTTP server simulating the device. The quickest way to do that may be using

package/doc/installationguide.md

@@ -72,6 +72,22 @@ overriding the group setting.
 }
 ```
 
+When connected to an **NGSI-LD** context broker, an IoT Agent is able to indicate whether it is willing to accept `null`
+values and also whether it is able to process the **NGSI-LD** `datasetId` metadata element. Setting these
+values to `false` will cause the IoT Agent to return a 400 **Bad Request** HTTP status code explaining that the IoT
+Agent does not support nulls or multi-attribute requests if they are encountered.
+
+```javascript
+{
+    baseRoot: '/',
+    port: 4041,
+    ldSupport : {
+      null: true,
+      datasetId: true
+    }
+}
+```
+
 -   **stats**: configure the periodic collection of statistics. Use `interval` in milliseconds to set the time between
     stats writings.
 
@@ -301,6 +317,8 @@ overrides.
 | IOTA_CB_NGSI_VERSION                 | `contextBroker.ngsiVersion`     |
 | IOTA_NORTH_HOST                      | `server.host`                   |
 | IOTA_NORTH_PORT                      | `server.port`                   |
+| IOTA_LD_SUPPORT_NULL                 | `server.ldSupport.null`         |
+| IOTA_LD_SUPPORT_DATASET_ID           | `server.ldSupport.datasetId`    |
 | IOTA_PROVIDER_URL                    | `providerUrl`                   |
 | IOTA_AUTH_ENABLED                    | `authentication.enabled`        |
 | IOTA_AUTH_TYPE                       | `authentication.type`           |

package/doc/usermanual.md

@@ -354,6 +354,83 @@ values.
 The handler is expected to call its callback once with no parameters (failing to do so may cause unexpected behaviors in
 the IoT Agent).
 
+##### iotagentLib.setCommandHandler()
+
+###### Signature
+
+```javascript
+function setCommandHandler(newHandler)
+```
+
+###### Description
+
+Sets the new user handler for registered entity commands. This handler will be called whenever a command request arrives, with
+the following parameters: (`id`, `type`, `service`, `subservice`, `attributes`, `callback`). The handler must retrieve
+all the corresponding information from the devices and return a NGSI entity with the requested values.
+
+The callback must be invoked with the updated Context Element, using the information retrieved from the devices. E.g.:
+
+```javascript
+callback(null, {
+    type: "TheType",
+    isPattern: false,
+    id: "EntityID",
+    attributes: [
+        {
+            name: "lumniscence",
+            type: "Lumens",
+            value: "432"
+        }
+    ]
+});
+```
+
+In the case of NGSI requests affecting multiple entities, this handler will be called multiple times, one for each
+entity, and all the results will be combined into a single response.  Only IoT Agents which deal with actuator devices will include a handler for commands.
+
+###### Params
+
+-   newHandler: User handler for command requests.
+
+##### iotagentLib.setMergePatchHandler()
+
+###### Signature
+
+```javascript
+function setMergePatchHandler(newHandler)
+```
+
+###### Description
+
+Sets the new user handler for NGSI-LD Entity [merge-patch](https://datatracker.ietf.org/doc/html/rfc7386) requests. This handler will be called whenever a merge-patch request arrives, with
+the following parameters: (`id`, `type`, `service`, `subservice`, `attributes`, `callback`). The handler must retrieve
+all the corresponding information from the devices and return a NGSI entity with the requested values.
+
+The callback must be invoked with the updated Context Element, using the information retrieved from the devices. E.g.:
+
+```javascript
+callback(null, {
+    type: "TheType",
+    isPattern: false,
+    id: "EntityID",
+    attributes: [
+        {
+            name: "lumniscence",
+            type: "Lumens",
+            value: "432"
+        }
+    ]
+});
+```
+
+In the case of NGSI-LD requests affecting multiple entities, this handler will be
+called multiple times. Since merge-patch is an advanced function, not all IoT Agents
+will include a handler for merge-patch.
+
+###### Params
+
+-   newHandler: User handler for merge-patch requests.
+
 ##### iotagentLib.setProvisioningHandler()
 
 ###### Signature

package/examples/TTOpen-service.json

@@ -3,7 +3,7 @@
     {
       "resource": "/iot/d",
       "apikey": "pipopi",
-      "cbroker": "http://127.0.0.1:10026",
+      "cbHost": "http://127.0.0.1:10026",
       "entity_type": "ThinkingThing"
     }
   ]

package/lib/commonConfig.js

@@ -158,7 +158,9 @@ function processEnvironmentVariables() {
         'IOTA_DEFAULT_ENTITY_NAME_CONJUNCTION',
         'IOTA_JSON_LD_CONTEXT',
         'IOTA_FALLBACK_TENANT',
-        'IOTA_FALLBACK_PATH'
+        'IOTA_FALLBACK_PATH',
+        'IOTA_LD_SUPPORT_NULL',
+        'IOTA_LD_SUPPORT_DATASET_ID'
     ];
     const iotamVariables = [
         'IOTA_IOTAM_URL',
@@ -263,6 +265,18 @@ function processEnvironmentVariables() {
         config.server.port = process.env.IOTA_NORTH_PORT;
     }
 
+    config.server.ldSupport = config.server.ldSupport || {null: true, datasetId: true, merge: false};
+
+    if (process.env.IOTA_LD_SUPPORT_NULL) {
+        config.server.ldSupport.null = process.env.IOTA_LD_SUPPORT_NULL === 'true';
+    }
+    if (process.env.IOTA_LD_SUPPORT_DATASET_ID) {
+        config.server.ldSupport.datasetId = process.env.IOTA_LD_SUPPORT_DATASET_ID === 'true';
+    }
+     if (process.env.IOTA_LD_SUPPORT_MERGE) {
+        config.server.ldSupport.datasetId = process.env.IOTA_LD_SUPPORT_MERGE === 'true';
+    }
+
     if (process.env.IOTA_PROVIDER_URL) {
         config.providerUrl = process.env.IOTA_PROVIDER_URL;
     }

package/lib/constants.js

@@ -60,6 +60,7 @@ module.exports = {
     SUBSERVICE_HEADER: 'fiware-servicepath',
     NGSI_LD_TENANT_HEADER: 'NGSILD-Tenant',
     NGSI_LD_PATH_HEADER: 'NGSILD-Path',
+    NGSI_LD_NULL: 'urn:ngsi-ld:null',
     //FIXME: check Keystone support this in lowercase, then change
     AUTH_HEADER: 'X-Auth-Token',
     X_FORWARDED_FOR_HEADER: 'x-forwarded-for',

package/lib/fiware-iotagent-lib.js

@@ -323,6 +323,7 @@ exports.getConfigurationSilently = groupConfig.getSilently;
 exports.findConfiguration = groupConfig.find;
 exports.setDataUpdateHandler = contextServer.setUpdateHandler;
 exports.setCommandHandler = contextServer.setCommandHandler;
+exports.setMergePatchHandler = contextServer.setMergePatchHandler;
 exports.setDataQueryHandler = contextServer.setQueryHandler;
 exports.setConfigurationHandler = contextServer.setConfigurationHandler;
 exports.setRemoveConfigurationHandler = contextServer.setRemoveConfigurationHandler;
@@ -363,7 +364,8 @@ exports.dataPlugins = {
     timestampProcess: require('./plugins/timestampProcessPlugin'),
     expressionTransformation: require('./plugins/expressionPlugin'),
     multiEntity: require('./plugins/multiEntity'),
-    bidirectionalData: require('./plugins/bidirectionalData')
+    bidirectionalData: require('./plugins/bidirectionalData'),
+    utils: require('./plugins/pluginUtils')
 };
 
 exports.alarms = require('./services/common/alarmManagement');

package/lib/jexlTranformsMap.js

@@ -49,6 +49,8 @@ const map = {
     replaceallstr: (str, from, to) => str.replaceAll(from, to),
     replaceallregexp: (str, reg, to) => str.replaceAll(new RegExp(reg, 'g'), to),
     split: (str, ch) => str.split(ch),
+    joinarrtostr: (arr, ch) => arr.join(ch),
+    concatarr: (arr, arr2) => arr.concat(arr2),
     mapper: (val, values, choices) => choices[values.findIndex((target) => target === val)],
     thmapper: (val, values, choices) =>
         choices[
@@ -67,7 +69,16 @@ const map = {
         return Array.from(s);
     },
     touppercase: (val) => String(val).toUpperCase(),
-    tolowercase: (val) => String(val).toLowerCase()
+    tolowercase: (val) => String(val).toLowerCase(),
+    floor: (val) => Math.floor(val),
+    ceil: (val) => Math.ceil(val),
+    round: (val) => Math.round(val),
+    tofixed: (val, decimals) => Number.parseFloat(val).toFixed(decimals),
+    gettime: (d) => new Date(d).getTime(),
+    toisostring: (d) => new Date(d).toISOString(),
+    // https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString
+    localestring: (d, timezone, options) => new Date(d).toLocaleString(timezone, options),
+    now: () => Date.now()
 };
 
 exports.map = map;

package/lib/plugins/jexlParser.js

@@ -141,8 +141,8 @@ function contextAvailable(expression, context) {
         jexl.evalSync(expression, context);
         return true;
     } catch (e) {
-        error = new errors.InvalidExpression(expression);
-        throw error;
+        logger.warn(logContext, 'Wrong expression found "[%j]" over "[%j]", it will be ignored', expression, context);
+        return false;
     }
 }
 

package/lib/services/devices/deviceService.js

@@ -132,7 +132,14 @@ function mergeArrays(original, newArray) {
  * @param {Object} configuration        Configuration data.
  */
 function mergeDeviceWithConfiguration(fields, defaults, deviceData, configuration, callback) {
-    logger.debug(context, 'deviceData before merge with conf: %j', deviceData);
+    logger.debug(
+        context,
+        'deviceData before merge with conf: %j defaults: %j fields: %j configuration %j',
+        deviceData,
+        defaults,
+        fields,
+        configuration
+    );
     for (let i = 0; i < fields.length; i++) {
         const confField = fields[i] === 'active' ? 'attributes' : fields[i];
         if (deviceData && deviceData[fields[i]] && ['active', 'lazy', 'commands'].indexOf(fields[i]) >= 0) {
@@ -356,12 +363,16 @@ function registerDevice(deviceObj, callback) {
                     deviceObj.type = deviceData.type;
                     deviceObj.staticAttributes = deviceData.staticAttributes;
                     deviceObj.commands = deviceData.commands;
+                    deviceObj.lazy = deviceData.lazy;
                     if ('timestamp' in deviceData && deviceData.timestamp !== undefined) {
                         deviceObj.timestamp = deviceData.timestamp;
                     }
                     if ('explicitAttrs' in deviceData && deviceData.explicitAttrs !== undefined) {
                         deviceObj.explicitAttrs = deviceData.explicitAttrs;
                     }
+                    if ('apikey' in deviceData && deviceData.apikey !== undefined) {
+                        deviceObj.apikey = deviceData.apikey;
+                    }
                     config.getRegistry().store(deviceObj, callback);
                 }
             }
@@ -619,8 +630,16 @@ function findOrCreate(deviceId, group, callback) {
             if ('expressionLanguage' in group && group.expressionLanguage !== undefined) {
                 newDevice.expressionLanguage = group.expressionLanguage;
             }
+            if (
+                (!('apikey' in newDevice) || newDevice.apikey === undefined) &&
+                'apikey' in group &&
+                group.apikey !== undefined
+            ) {
+                newDevice.apikey = group.apikey;
+            }
             // Check autoprovision flag in order to register or not device
             if (group.autoprovision === undefined || group.autoprovision === true) {
+                logger.debug(context, 'Registering autoprovision of Device %j for its conf %j', newDevice, group);
                 registerDevice(newDevice, function (error, device) {
                     callback(error, device, group);
                 });

package/lib/services/devices/devices-NGSI-v2.js

@@ -359,7 +359,9 @@ function updateRegisterDeviceNgsi2(deviceObj, entityInfoUpdated, callback) {
             if ('expressionLanguage' in newDevice && newDevice.expressionLanguage !== undefined) {
                 oldDevice.expressionLanguage = newDevice.expressionLanguage;
             }
-
+            if ('apikey' in newDevice && newDevice.apikey !== undefined) {
+                oldDevice.explicitAttrs = newDevice.apikey;
+            }
             oldDevice.endpoint = newDevice.endpoint || oldDevice.endpoint;
 
             callback(null, oldDevice);