Merge pull request #422 from doc4d/main

update translations

Author: arnaud4d

docs/API/TCPConnectionClass.md

@@ -176,6 +176,7 @@ In the *options* parameter, pass an object that can contain the following proper
 |onError|Formula|Callback triggered in case of an error|Undefined|
 |onTerminate|Formula|Callback triggered just before the TCPConnection is released|Undefined|
 |noDelay|Boolean|**Read-only** Disables Nagle's algorithm if `true`|False|
+|connectionTimeout|Real| Maximum time (in seconds) to establish the connection. If exceeded, the connection attempt is aborted| System-defined, generally ≥ 30 |
 
 
 #### Callback functions

docs/Notes/updates.md

@@ -4,9 +4,17 @@ title: Release Notes
 ---
 
 
+## 4D 20 R10
+
+Read [**What’s new in 4D 20 R10**](https://blog.4d.com/en-whats-new-in-4d-20-R10/), the blog post that lists all new features and enhancements in 4D 20 R10.
+
+#### Highlights
+
+- New `connectionTimeout` option in the [`options`](../API/TCPConnectionClass.md#options-parameter) parameter of the [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew) function.
+
 ## 4D 20 R9
 
-Read [**What’s new in 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-v20-R9/), the blog post that lists all new features and enhancements in 4D 20 R9.
+Read [**What’s new in 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-20-R9/), the blog post that lists all new features and enhancements in 4D 20 R9.
 
 #### Highlights
 
@@ -19,14 +27,14 @@ Read [**What’s new in 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-v20-R
 - Interpreted components can now be [edited from the host project](../Extensions/develop-components.md#editing-components-from-the-host). 
 - [Licenses](../Admin/licenses.md) are now automatically refreshed at startup. 
 - New [4D AIKit component](../aikit/overview.md) enabling interaction with third-party AI APIs.
-- The following VP command callbacks now wait for all 4D custom functions to complete their calculations: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-form-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), and [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md).
+- The following VP command callbacks now wait for all 4D custom functions to complete their calculations: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), and [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md).
 - New [4D Netkit](https://developer.4d.com/4D-NetKit/) features to manage Google and Microsoft 365 calendars; ability to use the host web server for OAuth 2.0 authentication. 
 - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R9): list of all bugs that have been fixed in 4D 20 R9.
 
 
 ## 4D 20 R8
 
-Read [**What’s new in 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-v20-R8/), the blog post that lists all new features and enhancements in 4D 20 R8.
+Read [**What’s new in 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-20-R8/), the blog post that lists all new features and enhancements in 4D 20 R8.
 
 #### Highlights
 
@@ -56,7 +64,7 @@ Read [**What’s new in 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-v20-R
 
 ## 4D 20 R7
 
-Read [**What’s new in 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d-v20-R7/), the blog post that lists all new features and enhancements in 4D 20 R7.
+Read [**What’s new in 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d-20-R7/), the blog post that lists all new features and enhancements in 4D 20 R7.
 
 #### Highlights
 

docs/ORDA/privileges.md

@@ -210,6 +210,52 @@ The `roles.json` file syntax is the following:
 
 :::
 
+#### Assigning permissions to ORDA class functions
+
+When configuring permissions, ORDA class functions are declared in the `applyTo` element using the following syntax:
+
+```json
+<DataclassName>.<functionName>
+```
+For example, if you want to apply a permission to the following function:
+
+```4d
+// cs.CityEntity class
+Class extends Entity
+  Function getPopulation() : Integer
+   ...
+```
+... you have to write:
+
+```json
+"applyTo":"City.getPopulation"
+```
+
+It means that you cannot use the same function names in the various ORDA classes (entity, entity selection, dataclass) if you want them to be assigned privileges. In this case, you need to use distinct function names. For example, if you have created a "drop" function in both `cs.CityEntity` and `cs.CitySelection` classes, you need to give them different names such as `dropEntity()` and `dropSelection()`. You can then write in the "roles.json" file:
+
+```json
+	"permissions": {
+		"allowed": [
+			{
+				"applyTo": "City.dropEntity",
+				"type": "method",
+				"promote": [
+					"name"
+				]
+			},
+			{
+				"applyTo": "City.dropSelection",
+				"type": "method",
+				"promote": [
+					"name"
+				]
+			}
+    ]
+```
+
+
+
+
 ### `Roles_Errors.json` file
 
 The `roles.json` file is parsed by 4D at startup. You need to restart the application if you want modifications in this file to be taken into account.

docs/commands-legacy/call-form.md

@@ -15,11 +15,11 @@ displayed_sidebar: docs
 
 <!-- END REF-->
 
-## Error management 
+## Description 
 
 <!--REF #_command_.CALL FORM.Summary-->The **CALL FORM** command executes the 4D code designated in *formula* with the optional *param*(s) in the context of a form displayed in a *window*, regardless of the process owning the window.<!-- END REF-->
 
-Just like in the worker-based interprocess communication feature (see *About workers*), a message box is associated with the window and can be used when the window displays a form (after the On Load form event). **CALL FORM** encapsulates the formula and its arguments in a message that is posted in the window's message box. The form then executes the message in its own process. The calling process can be cooperative or preemptive, thus this feature allows a preemptive process to exchange information with forms.
+Just like in the [worker-based interprocess communication feature](../Develop/processes.md#worker-processes), a message box is associated with the window and can be used when the window displays a form (after the [On Load](../Events/onLoad.md) form event). **CALL FORM** encapsulates the formula and its arguments in a message that is posted in the window's message box. The form then executes the message in its own process. The calling process can be cooperative or preemptive, thus this feature allows a preemptive process to exchange information with forms.
 
 In *window*, you pass the window reference number of the window displaying the called form.
 

docs/commands-legacy/multi-sort-array.md

@@ -12,8 +12,6 @@ displayed_sidebar: docs
 | --- | --- | --- | --- |
 | array | Array | →  | Array(s) to be sorted |
 | sort | * | &#8594;  | ">" to sort by increasing order or  "<" to sort by decreasing order If omitted  no sort |
-| MULTI SORT ARRAY ( ptrArrayName ; sortArrayName ) |
-| Parameter | Type | Description |
 | ptrArrayName | Pointer array | &#8594;  | Array of array pointers |
 | sortArrayName | Array integer | &#8594;  | Sort order array (1 = sort by increasing order, -1 = sort by decreasing order, 0 = synchronization with previous sorts) |
 

docs/commands-legacy/object-get-auto-spellcheck.md

@@ -19,6 +19,11 @@ displayed_sidebar: docs
 
 <!--REF #_command_.OBJECT Get auto spellcheck.Summary-->The **OBJECT Get auto spellcheck** command returns the status of the Auto spellcheck option for the object(s) designated by the *object* and *\** parameters for the current process.<!-- END REF-->
 
+This command supports objects of the following types:
+
+- Text-based [inputs](../FormObjects/input_overview.md)
+- [4D Write Pro areas](../FormObjects/writeProArea_overview.md).
+
 If you pass the optional *\** parameter, this indicates that the *object* parameter is an object name (a string). If you do not pass this parameter, this indicates that the *object* is a variable or a field. In this case, you pass a reference instead of a name.
 
 The command returns **True** when automatic spell-checking is enabled for the *object* and **False** when it is not. 

docs/commands-legacy/object-set-auto-spellcheck.md

@@ -17,10 +17,17 @@ displayed_sidebar: docs
 
 ## Description 
 
-<!--REF #_command_.OBJECT SET AUTO SPELLCHECK.Summary-->The **OBJECT SET AUTO SPELLCHECK** command sets or dynamically modifies the status of the **Auto spellcheck** option for the object(s) designated by the *object* and *\** parameters for the current process.<!-- END REF--> This option enables or disables the automatic spellcheck when data is entered for the object (Text type objects only).
+<!--REF #_command_.OBJECT SET AUTO SPELLCHECK.Summary-->The **OBJECT SET AUTO SPELLCHECK** command sets or dynamically modifies the status of the **Auto spellcheck** option for the object(s) designated by the *object* and *\** parameters for the current process.<!-- END REF--> This option enables or disables the automatic spellcheck when data is entered for the object.
+
+This command supports objects of the following types:
+
+- Text-based [inputs](../FormObjects/input_overview.md)
+- [4D Write Pro areas](../FormObjects/writeProArea_overview.md).
+
 
 If you pass the optional *\** parameter, this indicates that the *object* parameter is an object name (a string). If you do not pass this parameter, this indicates that the *object* is a variable or a field. In this case, you pass a reference instead of a name.
 
+
 Pass **True** in *autoSpellcheck* to enable this function for the object, and **False** to disable it.
 
 ## See also 

docs/commands/theme/Language.md

@@ -8,7 +8,7 @@ slug: /commands/theme/Language
 ||
 |---|
 |[<!-- INCLUDE #_command_.Action info.Syntax -->](../../commands-legacy/action-info.md)<br/>|
-|[<!-- INCLUDE #_command_.Call chain.Syntax -->](../../commands-legacy/call-chain.md)<br/>|
+|[<!-- INCLUDE #_command_.Call chain.Syntax -->](../call-chain.md)<br/>|
 |[<!-- INCLUDE #_command_.Command name.Syntax -->](../../commands/command-name.md)<br/>|
 |[<!-- INCLUDE #_command_.Copy parameters.Syntax -->](../../commands-legacy/copy-parameters.md)<br/>|
 |[<!-- INCLUDE #_command_.Count parameters.Syntax -->](../../commands-legacy/count-parameters.md)<br/>|

i18n/es/docusaurus-plugin-content-docs/current/API/CollectionClass.md

@@ -1073,7 +1073,7 @@ $c2:=$c.find(Formula($1.value.name=$2); "Clanton")  //$c2={name:Clanton,zc:35046
 | formula    | 4D.Function |              ->             | Objeto fórmula                                                        |
 | methodName | Text                        |              ->             | Nombre de un método                                                   |
 | param      | any                         |              ->             | Parámetro(s) a pasar a la *formula* o *methodName* |
-| Resultado  | Integer                     | <- | Conjunción                                                            |
+| Resultado  | Integer                     | <- | Índice del primer valor encontrado, o -1 si no se encuentra           |
 
 <!-- END REF -->
 
@@ -1527,7 +1527,7 @@ En *index*, pase la posición donde quiere insertar el elemento en la colección
 
 > **Atención**: recuerde que los elementos de la colección están numerados desde 0.
 
-- Ejemplo 1
+- Si *index* la longitud de la colección, el índice inicial real se fijará en la longitud de la colección.
 - Si *index* <0, se recalcula como *index:=index+length* (se considera el desplazamiento desde el final de la colección).
 - Si el valor calculado es negativo, index toma el valor 0.
 
@@ -1665,17 +1665,24 @@ En *toSearch*, pase la expresión a encontrar en la colección. Puede pasar:
 
 *toSearch* debe coincidir exactamente con el elemento a encontrar (se aplican las mismas reglas que para el operador de igualdad del tipo de datos).
 
-Ejemplo 2
+Opcionalmente, puede pasar el índice de la colección desde el cual iniciar una búsqueda en reversa en *startFrom*.
 
 - Si *startFrom* >= la longitud de la colección menos uno (coll.length-1), se busca en toda la colección (por defecto).
 - Si *startFrom* < 0, se recalcula como *startFrom:=startFrom+length* (se considera el desplazamiento desde el final de la colección). Si el valor calculado es negativo, se devuelve -1 (no se busca en la colección).
  **Nota:** incluso si *startFrom* es negativo, la colección se sigue buscando de derecha a izquierda.
-- Descripción
+- Si *startFrom* = 0, se devuelve -1 lo que significa que la colección no se busca.
 
 #### Ejemplo
 
 ```4d
-Tipo
+ var $col : Collection
+ var $pos1;$pos2;$pos3;$pos4;$pos5 : Integer 
+ $col:=Split string("a,b,c,d,e,f,g,h,i,j,e,k,e";",") //$col.length=13
+ $pos1:=$col.lastIndexOf("e") //devuelve 12
+ $pos2:=$col.lastIndexOf("e";6) //devuelve 4
+ $pos3:=$col.lastIndexOf("e";15) //devuelve 12
+ $pos4:=$col.lastIndexOf("e";-2) //devuelve 10
+ $pos5:=$col.lastIndexOf("x") //devuelve -1
 ```
 
 <!-- END REF -->
@@ -1794,13 +1801,13 @@ $c2:=$c.map(Formula(Round(($1.value/$2)*100; 2)); $c.sum())
 
 #### Descripción
 
-Diferente de Si *startFrom* < 0, se considera el desplazamiento desde el final de la colección (*startFrom:=startFrom+length*).
+La función `.max()` <!-- REF #collection.max().Summary -->devuelve el elemento con el valor más alto de la colección<!-- END REF --> (el último elemento de la colección tal y como se ordenaría en orden ascendente utilizando la función [`.sort()`](#sort)).
 
 > Esta función no modifica la colección original.
 
-La función `.max()` <!-- REF #collection.max().Summary -->devuelve el elemento con el valor más alto de la colección <!-- END REF --> (el último elemento de la colección, ya que sería ordenado en orden ascendente usando el [`.sort()`](#sort) función).
+Si la colección contiene diferentes tipos de valores, la función `.max()` devolverá el valor máximo dentro del último tipo de elemento en el orden de la lista de tipos (ver la descripción de [`.sort()`](#sort)).
 
-Lanzamiento
+Si la colección contiene objetos, pase el parámetro *propertyPath* para indicar la propiedad del objeto cuyo valor máximo desea obtener.
 
 Si la colección está vacía, `.max()` devuelve *Undefined*.
 
@@ -2685,9 +2692,9 @@ Puede pasar el valor para inicializar el acumulador en *initValue*. Si se omite,
 
 La retrollamada recibe los siguientes parámetros:
 
-- La nueva colección
-- Se puede insertar cualquier tipo de elemento aceptado por una colección, incluso otra colección.
-- Esta función modifica la colección original.
+- en *$1.value*: valor del elemento a procesar
+- en *$2: param*
+- en *$N...*: *paramN...*
 
 La retrollamada define los siguientes parámetros:
 
@@ -2770,9 +2777,9 @@ Puede pasar el valor para inicializar el acumulador en *initValue*. Si se omite,
 
 La retrollamada recibe los siguientes parámetros:
 
-- La nueva colección
-- Se puede insertar cualquier tipo de elemento aceptado por una colección, incluso otra colección.
-- Esta función modifica la colección original.
+- en *$1.value*: valor del elemento a procesar
+- en *$2: param*
+- en *$N...*: *paramN...*
 
 La retrollamada define los siguientes parámetros:
 
@@ -3077,7 +3084,7 @@ La colección devuelta contiene el elemento especificado por *startFrom* y todos
 
 #### Descripción
 
-Lanzamiento
+La función `.some()` <!-- REF #collection.some().Summary --> devuelve true si al menos un elemento de la colección ha pasado con éxito una prueba implementada en el código *formula* o *methodName* suministrado<!-- END REF -->.
 
 Se designa el código 4D de retrollamada (callback) a ejecutar para evaluar los elementos de la colección utilizando:
 
@@ -3088,16 +3095,16 @@ La retrollamada se llama con los parámetros pasados en *param* (opcional). La r
 
 La retrollamada recibe los siguientes parámetros:
 
-- La nueva colección
-- Se puede insertar cualquier tipo de elemento aceptado por una colección, incluso otra colección.
-- Esta función modifica la colección original.
+- en *$1.value*: valor del elemento a procesar
+- en *$2: param*
+- en *$N...*: *paramN...*
 
 Puede definir los siguientes parámetros:
 
 - Expresión a buscar en la colección
 - *$1.stop* (boolean, opcional): **true** para detener la retrollamada del método. El valor devuelto es el último calculado.
 
-Descripción
+En todo caso, en el momento en que la función `.some()` encuentra el primer elemento de la colección que devuelve true, deja de llamar a la llamada de retorno y devuelve **true**.
 
 Por defecto, `.some()` comprueba toda la colección. Opcionalmente, puede pasar el índice de un elemento desde el cual iniciar la prueba en *startFrom*.
 
@@ -3179,7 +3186,7 @@ La retrollamada recibe los siguientes parámetros:
  - *$1.value2* (todo tipo): valor del segundo elemento a comparar
 - $2...$N (cualquier tipo): parámetros adicionales
 
-Resultado
+If you used a method, you must set the folllowing parameter:
 
 - Elemento a insertar en la colección
 
@@ -3203,7 +3210,10 @@ Resultado
 #### Ejemplo 3
 
 ```4d
-Descripción
+var $col; $col2; $col3 : Collection
+$col:=New collection(33;4;66;1111;222)
+$col2:=$col.sort() //numerical sort: [4,33,66,222,1111]
+$col3:=$col.sort(Formula(String($1.value)<String($1.value2))) //alphabetical sort: [1111,222,33,4,66]
 ```
 
 <!-- END REF -->
@@ -3239,7 +3249,7 @@ Para el cálculo sólo se tienen en cuenta los elementos numéricos (se ignoran
 
 Si la colección contiene objetos, pasa el parámetro *propertyPath* para indicar la propiedad del objeto a tener en cuenta.
 
-Esta función no modifica la colección original.
+`.sum()` devuelve 0 si:
 
 - la colección está vacía,
 - la colección no contiene elementos numéricos,

i18n/es/docusaurus-plugin-content-docs/current/API/EntityClass.md

@@ -866,7 +866,7 @@ El valor resultante se incluye entre 0 y la longitud de la selección de entidad
 
 #### Descripción
 
-True si la entidad acaba de ser creada y aún no se ha guardado. .
+La función `.isNew()` <!-- REF #EntityClass.isNew().Summary --> devuelve True si la entidad a la que se aplica acaba de ser creada y aún no ha sido guardada en el datastore<!-- END REF -->. .
 
 #### Ejemplo