4d
diff --git a/‎README.md‎
Lines changed: 6 additions & 0 deletions b/‎README.md‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎docs/API/DataClassClass.md‎
Lines changed: 104 additions & 26 deletions b/‎docs/API/DataClassClass.md‎
Lines changed: 104 additions & 26 deletions
diff --git a/‎docs/API/EntityClass.md‎
Lines changed: 2 additions & 0 deletions b/‎docs/API/EntityClass.md‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎docs/API/SessionClass.md‎
Lines changed: 2 additions & 6 deletions b/‎docs/API/SessionClass.md‎
Lines changed: 2 additions & 6 deletions
diff --git a/‎docs/Admin/data-collect.md‎
Lines changed: 59 additions & 100 deletions b/‎docs/Admin/data-collect.md‎
Lines changed: 59 additions & 100 deletions
diff --git a/‎docs/Notes/updates.md‎
Lines changed: 2 additions & 0 deletions b/‎docs/Notes/updates.md‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎docs/REST/$filter.md‎
Lines changed: 41 additions & 2 deletions b/‎docs/REST/$filter.md‎
Lines changed: 41 additions & 2 deletions
diff --git a/‎docs/WebServer/sessions.md‎
Lines changed: 6 additions & 0 deletions b/‎docs/WebServer/sessions.md‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎docs/aikit/Classes/OpenAIChatCompletionsAPI.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/aikit/Classes/OpenAIChatCompletionsAPI.md‎
Lines changed: 1 addition & 1 deletion
@@ -185,6 +185,12 @@ Sur github, faire une PR de docs4d/docs/main sur 4d/docs/main
 ### Algolia (4D only)
 Aller dans l'interface Algolia et lancer un reindex de la doc
 
+## Mise à jour prod
+1. Créer une nouvelle branche en local nommée par exemple Tempo
+2. faire git fetch upstream (met à jour la preprod avec la prod)
+3. faire git rebase upstream/main -X ours (remettre tout dans Tempo et en cas de conflit prendre la preprod)
+4. git push (fait une PR auto et pas de conflit)
+
 
 
 
 
@@ -1765,6 +1765,8 @@ The object returned by `.unlock()` contains the following property:
 |Property| Type |Description|
 |---|---|---|
 |success| Boolean| True if the unlock action is successful, False otherwise. If the unlock is done on a dropped entity, on a non locked record, or on a record locked by another process or entity, success is False.|
+|wasNotLocked| Boolean|(only if "success" is False) True if the entity was not locked in the process.|
+
 
 #### Example  
 
 
@@ -7,11 +7,11 @@ title: Session
 Session objects are returned by the [`Session`](../commands/session.md) command. These objects provide the developer with an interface allowing to manage the current user session and execute actions such as store contextual data, share information between session processes, launch session-related preemptive processes, or (web only) manage [privileges](../ORDA/privileges.md).
 
 
-:::info To learn more
+:::tip Related blog posts
 
-Blog posts about this feature:
 - [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/)
 - [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/)
+- [Generate, share and use web sessions One-Time Passcodes (OTP)](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/)
 
 :::
 
@@ -58,10 +58,6 @@ The availability of properties and functions in the `Session` object depends on
 |[<!-- INCLUDE #SessionClass.userName.Syntax -->](#username)<br/><!-- INCLUDE #SessionClass.userName.Summary -->|
 
 
-### To learn more
-
-[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)<br/>
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post)
 
 <!-- REF SessionClass.clearPrivileges().Desc -->
 ## .clearPrivileges()
 
@@ -25,121 +25,80 @@ Data is collected during the following events:
 
 Some data is also collected at regular intervals.
 
-### Collected at database startup
 
 |Data|Type|Notes|
 |---|----|---|
-|CPU|Text|Name, type, and speed of the processor|
-|numberOfCores|Number|Total number of cores|
-|memory|Number|Volume of memory storage (in bytes) available on the machine|
-|system|Text|Operating system version and build number|
-|headless|Boolean|True if the application is running in headless mode|
-|version|Number|Version number of the 4D application|
 |buildNumber|Number|Build number of the 4D application|
-|license|Object|Commercial name and description of product licenses|
-|isRosetta|Boolean|True if 4D is emulated through Rosetta on macOS, False otherwise (not emulated or on Windows).|
-|uniqueID|Text|Unique ID of the 4D Server|
-|id|Text (hashed string)|Unique id associated to the database (*Polynomial Rolling hash of the database name*)|
-|dataFileSize|Number|Data file size in bytes|
-|indexesSize|Number|Index size in bytes|
-|cacheSize|Number|Cache size in bytes|
-|usingLegacyNetworkLayer|Boolean|True if legacy network layer used for the application server|
-|usingQUICNetworkLayer|Boolean|True if the database uses the QUIC network layer|
-|encryptedConnections|Boolean|True if client/server connections are encrypted|
-|encrypted|Boolean|True if the data file is encrypted|
-|compiled|Boolean|True if the application is compiled|
-|isEngined|Boolean|True if the application is merged with 4D Volume Desktop|
-|projectMode|Boolean|True if the application is a project|
-|mobile|Collection|Information on mobile sessions|
-
-### Collected at web server startup and data collection sending
-
-|Data|Type|Notes|
-|---|----|---|
-|webServer|Object|"started":true if the web server is starting or started|
-
-### Collected at new web session creation
-
-|Data|Type|Notes|
-|---|----|---|
-|databases.webMaxLicensedSessions|Number|Maximum number of non-REST web sessions on the server that use the webserver license|
-|databases.restMaxLicensedSessions|Number|Maximum number of REST web sessions on the server that use the REST license|
-|databases.webMaxUnlicensedSessions|Number|Maximum number of other non-REST web sessions on the server|
-|databases.restMaxUnlicensedSessions|Number|Maximum number of other REST web sessions on the server|
-
-### Collected at datastore opening
-
-|Data|Type|Notes|
-|---|----|---|
-|databases.externalDatastoreOpened|Number|Number of calls to `Open datastore`|
-|databases.internalDatastoreOpened|Number|Number of times the datastore is opened by an external server|
-
-
-### Collected at regular intervals
-
-|Data|Type|Notes|
-|---|----|---|
-|maximumNumberOfWebProcesses|Number|Maximum number of simultaneous web processes|
-|maximumUsedPhysicalMemory|Number|Maximum use of physical memory|
-|maximumUsedVirtualMemory|Number|Maximum use of virtual memory|
-
-
-### Collected at data collection sending
-
-|Data|Type|Notes|
-|---|----|---|
-|uptime|Number|Time elapsed (in seconds) since local 4D database was opened|
-|cacheReadBytes|Object|Number of bytes read from cache|
 |cacheMissBytes|Object|Number of bytes missed from cache |
-|cacheReadCount|Object|Number of reads in the cache |
 |cacheMissCount|Object|Number of reads missed in the cache |
+|cacheReadBytes|Object|Number of bytes read from cache|
+|cacheReadCount|Object|Number of reads in the cache |
+|cacheSize|Number|Cache size in bytes|
+|compiled|Boolean|True if the application is compiled|
+|connectionSystems|Collection|Client OS without the build number (in parenthesis) and number of clients using it|
+|CPU|Text|Name, type, and speed of the processor|
+|dataFileSize|Number|Data file size in bytes|
 |dataSegment1.diskReadBytes|Object|Number of bytes read in the data file |
-|dataSegment1.diskWriteBytes|Object|Number of bytes written in the data file |
 |dataSegment1.diskReadCount|Object|Number of reads in the data file |
+|dataSegment1.diskWriteBytes|Object|Number of bytes written in the data file |
 |dataSegment1.diskWriteCount|Object|Number of writes in the data file |
+|databases.externalDatastoreOpened|Number|Number of calls to `Open datastore`|
+|databases.internalDatastoreOpened|Number|Number of times the datastore is opened by an external server|
+|databases.remoteDebugger4DRemoteAttachments|Number|Number of attachments to the remote debugger from a remote 4D|
+|databases.remoteDebuggerQodlyAttachments|Number|Number of attachments to the remote debugger from Qodly|
+|databases.remoteDebuggerVSCodeAttachments|Number|Number of attachments to the remote debugger from VS Code|
+|databases.restMaxLicensedSessions|Number|Maximum number of REST web sessions on the server that use the REST license|
+|databases.restMaxUnlicensedSessions|Number|Maximum number of other REST web sessions on the server|
+|databases.webIPAddressesNumber|Number|Number of different IP addresses that made a request to 4D Server |
+|databases.webMaxLicensedSessions|Number|Maximum number of non-REST web sessions on the server that use the webserver license|
+|databases.webMaxUnlicensedSessions|Number|Maximum number of other non-REST web sessions on the server|
+|databases.webScalableSessions|Boolean|True if scalable sessions are activated |
+|encrypted|Boolean|True if the data file is encrypted|
+|encryptedConnections|Boolean|True if client/server connections are encrypted|
+|externalPHP|Boolean|True if the client performs a call to `PHP execute` and uses its own version of php |
+|hasDataChangeTracking|Boolean|True if a "__DeletedRecords" table exists|
+|headless|Boolean|True if the application is running in headless mode|
+|id|Text (hashed string)|Unique id associated to the database (*Polynomial Rolling hash of the database name*)|
 |indexSegment.diskReadBytes|Number|Number of bytes read in the index file|
-|indexSegment.diskWriteBytes|Number|Number of bytes written in the index file |
 |indexSegment.diskReadCount|Number|Number of reads in the index file |
+|indexSegment.diskWriteBytes|Number|Number of bytes written in the index file |
 |indexSegment.diskWriteCount|Number|Number of writes in the index file |
-|databases.webScalableSessions|Boolean|True if scalable sessions are activated |
-|databases.webIPAddressesNumber|Number|Number of different IP addresses that made a request to 4D Server |
-
-
-### Collected at database closure and data collection sending
-
-|Data|Type|Notes|
-|---|----|---|
-|webserverHits|Number|Number of hits on the web server during the data collection|
+|indexesSize|Number|Index size in bytes|
+|isEngined|Boolean|True if the application is merged with 4D Volume Desktop|
+|isRosetta|Boolean|True if 4D is emulated through Rosetta on macOS, False otherwise (not emulated or on Windows).|
+|LDAPLogin|Number|Number of calls to `LDAP LOGIN`|
+|license|Object|Commercial name and description of product licenses|
+|maximum4DClientConnections|Number|Maximum number of 4D Client connections to the server |
+|maximumNumberOfWebProcesses|Number|Maximum number of simultaneous web processes|
+|maximumUsedPhysicalMemory|Number|Maximum use of physical memory|
+|maximumUsedVirtualMemory|Number|Maximum use of virtual memory|
+|memory|Number|Volume of memory storage (in bytes) available on the machine|
+|mobile|Collection|Information on mobile sessions|
+|numberOfCores|Number|Total number of cores|
+|numberOfFields|Number|Number of fields|
+|numberOfKeepRecordSyncInfo|Number|Number of tables with the "Enable Replication" option checked|
+|numberOfRecordsMax|Number|Total number of records|
+|numberOfTables|Number|Number of tables|
+|numberOfWebServices|Number|Number of methods published as Web Services|
+|ODBCLogin|Number|Number of calls to `SQL LOGIN` using ODBC|
+|phpCall|Number|Number of calls to `PHP execute` |
+|projectMode|Boolean|True if the application is a project|
+|qodly.webforms|Number|Number of Qodly webforms|
+|QueryBySQL|Number|Number of calls to `QUERY BY SQL`|
 |restHits|Number|Number of hits on the REST server during the data collection|
+|SQLBeginEndStatement|Number|Number of uses of `Begin SQL` / `End SQL`|
+|SQLLoginInternal|Number|Number of calls to `SQL LOGIN` using SQL_INTERNAL|
+|SQLServer|Number|Number of SQL requests through the network|
+|system|Text|Operating system version and build number|
+|uniqueID|Text|Unique ID of the 4D Server|
+|uptime|Number|Time elapsed (in seconds) since local 4D database was opened|
+|usingLegacyNetworkLayer|Boolean|True if legacy network layer used for the application server|
+|usingQUICNetworkLayer|Boolean|True if the database uses the QUIC network layer|
+|version|Number|Version number of the 4D application|
+|webServer|Object|"started":true if the web server is starting or started|
 |webserverBytesIn|Number|Bytes received by the web server during the data collection|
 |webserverBytesOut|Number|Bytes sent by the web server during the data collection|
-|qodly.webforms|Number|Number of Qodly webforms|
-
-
-### Collected at every new call to the remote debugger 
-
-|Data|Type|Notes|
-|---|----|---|
-|databases.remoteDebugger4DRemoteAttachments|Number|Number of attachments to the remote debugger from a remote 4D|
-|databases.remoteDebuggerQodlyAttachments|Number|Number of attachments to the remote debugger from Qodly|
-|databases.remoteDebuggerVSCodeAttachments|Number|Number of attachments to the remote debugger from VS Code|
-
-
-### Collected every time PHP execute is called
-
-|Data|Type|Notes|
-|---|----|---|
-|phpCall|Number|Number of calls to `PHP execute` |
-|externalPHP|Boolean|True if the client performs a call to `PHP execute` and uses its own version of php |
-
-
-### Collected at client connection 
-
-|Data|Type|Notes|
-|---|----|---|
-|maximum4DClientConnections|Number|Maximum number of 4D Client connections to the server |
-|connectionSystems|Collection|Client OS without the build number (in parenthesis) and number of clients using it|
-
+|webserverHits|Number|Number of hits on the web server during the data collection|
 
 
 ## Where is it stored and sent?
 
@@ -9,6 +9,7 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th
 
 #### Highlights
 
+- Support of **AI Vector Searches** in the [`query()`](../API/DataClassClass.md#query-by-vector-similarity) function and in the [`$filter`](../REST/$filter.md#vector-similarity) REST API.
 - The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. 
 - Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class.
 - 4D Language:
@@ -316,4 +317,5 @@ See [**Release Notes for 4D 20.x LTS**](../../versioned_docs/version-20/Notes/up
 |PHP|8.2.4|20||
 |SpreadJS|17.1.0|20 R7|See [this blog post](https://blog.4d.com/4d-view-pro-whats-new-in-4d-20-r7/) for an overview of the new features|
 |webKit|WKWebView|19||
+|Xerces|3.3.0|**21**|Used for XML commands|
 |Zlib|1.3.1|**21**||
@@ -31,9 +31,9 @@ For example: `$filter="firstName=john AND salary>20000"` where `firstName` and `
 
 ### Using the params property
 
-You can also use 4D's params property.
+You can also use 4D's `params` property which is a collection of values.
 
-**\{attribute\} {comparator} {placeholder} {AND/OR/EXCEPT} \{attribute\} {comparator} {placeholder}&$params='["{value1}","{value2}"]"'**
+**\{attribute\} {comparator} {placeholder} {AND/OR/EXCEPT} \{attribute\} {comparator} {placeholder}&$params='["{value1}","{value2}"]'**
 
 For example: `$filter="firstName=:1 AND salary>:2"&$params='["john",20000]'` where firstName and salary are attributes in the Employee dataclass.
 
@@ -51,6 +51,9 @@ For more information regarding how to query data in 4D, refer to the [dataClass.
 > If you pass the value directly, you can write the following:
 `http://127.0.0.1:8081/rest/Person/?$filter="lastName=O'Reilly"`
 
+
+
+
 ## Attribute
 
 If the attribute is in the same dataclass, you can just pass it directly (*e.g.*, `firstName`). However, if you want to query another dataclass, you must include the relation attribute name plus the attribute name, i.e. the path (*e.g.*, employer.name). The attribute name is case-sensitive (`firstName` is not equal to `FirstName`).
@@ -83,6 +86,36 @@ The comparator must be one of the following values:
 |<=	|less than or equal to|
 |begin	|begins with|
 
+
+## Vector similarity
+
+If the attribute stores [**vector objects**](../API/VectorClass.md) (see how to [configure a 4D field to only store 4D.Vector class objects](../Develop/field-properties.md#class)), you can filter the dataclass using **vectors**, aka **embeddings**. 
+
+For more information about vector similarity searches, please refer to [Query by vector similarity](../API/DataClassClass.md#query-by-vector-similarity) section. 
+
+Use the `params` property to provide the filter with the vector comparison parameter, using a syntax like:
+
+**\{vectorAttribute\} \{comparator\} \{placeholder\}&$params=vectorComparison**
+
+The *vectorComparison* parameter is a collection of the following elements:
+
+|Property|Type|Description|
+|---|---|---|
+|[].vector|Collection of objects)|Mandatory. A collection that represents the vector to compare|
+|[].metric|Text|Optional. [Vector computation](../API/VectorClass.md#understanding-the-different-vector-computations) to use for the query. Supported values:<li>"cosine" (default if omitted): calculates the cosine distance between vectors.</li><li>"dot": calculates the dot similarity of vectors.</li><li>"euclidean": calculates the Euclidean distance between vectors.|
+||[].threshold|Real|Optional (default: 0.5). A threshold value used to filter vector comparisons based on their cosine, dot or euclidean similarity score according to the selected "metric". It is highly recommended to choose a similarity that best fits your specific use case for optimal results.|
+
+Only a subset of **comparator** symbols are supported with vector comparisons. Note that they compare results to the threshold value: 
+
+ |Comparator| Symbol(s)| Comment|
+ |---|---|---|
+ |Less than| <| Lower than the threshold|
+ |Greater than| > |Greater than the threshold|
+ |Less than or equal to| <=|Lower than or equal to the threshold|
+ |Greater than or equal to| >= |Greater than or equal to the threshold|
+
+
+
 ## Examples
 
 In the following example, we look for all employees whose last name begins with a "j":
@@ -103,3 +136,9 @@ In this example, we search the Person dataclass for all the people whose number
 ```
  GET  /rest/Person/?filter="anotherobj.mynum > 50"
 ```
+
+In this example, we do a vector search with basic values:
+
+```
+ GET  /rest/Person/?filter="VectorAtt>=:1"&$params='[{vector:[1,2,3],threshold:1}]'
+```
@@ -12,6 +12,12 @@ Web sessions allow to:
 - store and share data between processes of a web client using the [.storage](../API/SessionClass.md#storage) of the session,
 - associate privileges to the user running the session.
 
+:::tip Related blog post
+
+[Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/)
+
+:::
+
 ## Usages
 
 Web sessions are used for:
 
@@ -32,7 +32,7 @@ Provide the full messages list
 ```4d
 var $messages:=[]
 $messages.push({role: "system"; content: "You are a helpful assistant."})
-$messages.push({"role":"user"; "content": "Hello, how are you?"})
+$messages.push({role: "user"; content: "Hello, how are you?"})
 // ...
 
 var $result:=$client.chat.completions.create($messages; {model: "gpt-4o-mini" })