Collection, se utiliza la notación \[ ] para manejar todas las ocurrencias (por ejemplo "niños[ ].edad"). En el caso de una ruta de atributo cuyo tipo es `Collection`, se utiliza la notación `[]` para manejar todas las ocurrencias (por ejemplo `children[].age`).
+- **attributePath**: ruta del atributo sobre el que se quiere ejecutar la búsqueda. Este parámetro puede ser un nombre simple (por ejemplo, "país") o cualquier ruta de atributo válida (por ejemplo, "país.nombre".) En el caso de una ruta de atributo cuyo tipo es `Collection`, se utiliza la notación `[]` para manejar todas las ocurrencias (por ejemplo `children[].age`).
> \*No puede utilizar directamente atributos cuyo nombre contenga caracteres especiales como ".", "\[ ]", o "=", ">", "#"..., porque se evaluarán incorrectamente en la cadena de consulta. Si necesita consultar dichos atributos, debe considerar el uso de marcadores, que permiten un rango ampliado de caracteres en las rutas de los atributos (ver **Uso de marcadores de posición** *a continuación*)
@@ -943,8 +943,8 @@ Las fórmulas en las consultas pueden recibir parámetros a través de $1. Este
| Incluído en | IN | Devuelve los datos iguales a al menos uno de los valores de una colección o de un conjunto de valores, admite el comodín (@) |
| Contiene palabra clave | % | Las palabras claves pueden utilizarse en atributos de tipo texto o imagen |
-- Puede ser un **marcador de posición** (ver **Uso de marcadores de posición** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades. Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20.
- For example, if the string "v20" is entered as value to compare with an integer attribute, it will be converted to 20.
+- **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades. Puede ser un **marcador de posición** (ver **Uso de marcadores de posición** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. Por ejemplo, si se introduce la cadena "v20" como **value** para comparar con un atributo entero, se convertirá a 20. For example, if the string "v20" is entered as value to compare with an integer attribute, it will be converted to 20.
+ Tenga en cuenta que, en caso de no coincidencia de tipo con tipos escalares (texto, fecha, número...), 4D intentará convertir el tipo **value** al tipo de datos del atributo siempre que sea posible, para un manejo más fácil de los valores procedentes de Internet.
- La constante de tipo **texto** puede pasarse con o sin comillas simples (ver **Uso de comillas** más abajo). Para consultar una cadena dentro de otra cadena (una consulta de tipo "contiene"), utilice el símbolo de comodín (@) en el valor para aislar la cadena a buscar como se muestra en este ejemplo: "@Smith@". Las siguientes palabras claves están prohibidas para las constantes de texto: true, false.
- Valores constantes de tipo **booleano**: **true** o **false** (Sensible a las mayúsculas y minúsculas).
- Valores constantes de **tipo numérico**: los decimales se separan con un '.' (punto).
@@ -1038,6 +1038,20 @@ No obtendrá el resultado esperado porque el valor null será evaluado por 4D co
$vSingles:=ds.Person.query("spouse = null") // Sintaxis correcta
```
+#### Not equal to null or undefined values
+
+The "not equal to *value*" comparator (`#` or `!=`) does not return attributes whose value is null or undefined. For example, the following query will only return persons whose "info.married" status is `false` and not persons whose "info.married" property is "null" or missing:
+
+```4d
+$notMarried:=ds.Person.query("info.married#true") //finds persons with attribute value is false
+```
+
+If you want to find persons whose "info.married" status is `false`, null, or not defined, you need to write:
+
+```4d
+$notMarried:=ds.Person.query("info.married#true | info.married=null") //finds false, null and undefined attributes
+```
+
#### No igual a en colecciones
Al buscar dentro de atributos de objetos de dataclass que contengan las colecciones, el comparador "not equal to *value*" (`#` o `!=`) encontrará los elementos en los que TODAS las propiedades sean diferentes de *value* (y no aquellos en los que AL MENOS una propiedad sea diferente de *value*, que es como funcionan otros comparadores). Básicamente, equivale a buscar "Not(buscar elementos de la colección cuya propiedad sea igual a *value*"). Por ejemplo, con las siguientes entidades:
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/EntityClass.md
index 1316b6605e2a94..0e72b0ec7d25eb 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/EntityClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/EntityClass.md
@@ -98,11 +98,11 @@ El tipo de valor del atributo depende del tipo [kind](DataClassClass.md#attribut
#### Descripción
-The `.clone()` function creates in memory a new entity referencing the same record as the original entity.
+La función `.clone()` crea en la memoria una nueva entidad que hace referencia al mismo registro que la entidad original.
This function allows you to update entities separately. Note however that, for performance reasons, the new entity shares the same reference of object attributes as the cloned entity.
-> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed.
+> Tenga en cuenta que toda modificación realizada a las entidades se guardará en el registro referenciado sólo cuando se ejecute la función [`.save()`](#save).
Esta función sólo puede utilizarse con entidades ya guardadas en la base de datos. No se puede llamar a una entidad recién creada (para la que [`isNew()`](#isnew) devuelve **True**).
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md
index 88ff2672a2f23b..f0643847bb8541 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md
@@ -198,7 +198,7 @@ Esta propiedad está en **lectura-escritura**.
#### Descripción
-Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`.
+Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`.
Esta propiedad es de **solo lectura**.
@@ -230,7 +230,7 @@ Esta propiedad es de **solo lectura**.
La función `.trigger( )` define la propiedad `signaled` del objeto signal como **true** y despierta a todos los workers o procesos que esperan esta signal.
-Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\\\\\` ya es **true**), la función no hace nada.
+Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\\\\\\\\` ya es **true**), la función no hace nada.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/basics.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/basics.md
index 73a474557f624c..f71990358b5253 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/basics.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/basics.md
@@ -70,27 +70,27 @@ La ventana de error de sintaxis propone varias opciones:
- **Continuar**: la ejecución continua. La línea con el error puede ser parcialmente ejecutada, dependiendo de donde se encuentre el error. Continúe con precaución: el error puede impedir que el resto de su método se ejecute correctamente. Recomendamos hacer clic en **Continuar** sólo si el error está en una llamada trivial (como `SET WINDOW TITLE`) que no impide ejecutar y probar el resto de su código.
-> Consejo: para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede convertir el botón **Continuar** en un botón **Ignorar**. Mantenga presionada la tecla **Alt** (Windows) u **Opción** (macOS) y haga clic en el botón **Continuar** la primera vez que aparece. La etiqueta del botón cambia a **Ignorar** si el diálogo es llamado de nuevo por el mismo error.
+> Consejo: para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede convertir el botón **Continuar** en un botón **Ignorar**. Hold down **Alt** (Windows) or **Option** (macOS) key and click the **Continue** button the first time it appears. The button label changes to **Ignore** if the dialog is called again for the same error.
-- **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método:
+- **Abort**: Stops method execution and returns to the state before the method started executing:
- Si un método formulario o método objeto se está ejecutando en respuesta a un evento, se detiene y se vuelve al formulario.
- Si el método se está ejecutando desde dentro del entorno de la aplicación, volverá a ese entorno.
-- **Copiar**: copia la información de depuración en el portapapeles. La información describe el entorno interno del error (número, componente interno, etc.). Está formateado como texto tabulado.
+- **Copy**: Copies the debugging information into the clipboard. La información describe el entorno interno del error (número, componente interno, etc.). Está formateado como texto tabulado.
-- **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`.
+- **Save...**: Saves the contents of the syntax error window and the call chain in a `.txt` file.
## Debugger
-Un error común de los principiantes al tratar con la detección de errores es hacer clic en **Abandonar** en la ventana de error de sintaxis, volver al editor de código, y tratar de averiguar lo que está pasando mirando el código. ¡No lo haga! Ahorrará mucho tiempo y energía utilizando siempre el **Depurador**.
+A common beginner mistake in dealing with error detection is to click **Abort** in the Syntax Error Window, go back to the Code Editor, and try to figure out what's going by looking at the code. ¡No lo haga! Ahorrará mucho tiempo y energía utilizando siempre el **Depurador**.
El depurador le permite pasar lentamente por los métodos. Muestra toda la información que necesita para entender por qué ha ocurrido un error. Una vez que tiene esta información, usted sabe cómo arreglar el error.
-Otra razón para usar el Depurador es el desarrollo del código. A veces se puede escribir un algoritmo que es más complejo de lo habitual. A pesar de todos los sentimientos de cumplimiento, no puede estar totalmente seguro de que su codificación sea 100% correcta. En lugar de ejecutarlo "ciego", puede utilizar el comando `TRACE` al comienzo de su código, luego ejecutarlo paso a paso para mantener un ojo en lo que sucede.
+Otra razón para usar el Depurador es el desarrollo del código. A veces se puede escribir un algoritmo que es más complejo de lo habitual. A pesar de todos los sentimientos de cumplimiento, no puede estar totalmente seguro de que su codificación sea 100% correcta. Instead of running it "blind", you can use the `TRACE` command at the beginning of your code, then execute it step by step to keep an eye on what happens.
## Rupturas
En el proceso de depuración, puede que necesite saltar el seguimiento de algunas partes del código hasta una línea determinada. O, puede querer rastrear el código cuando una expresión dada tiene un determinado valor (e.. "$myVar > 1000"), o cada vez que se llama un comando 4D específico.
-Estas necesidades están cubiertas por **puntos de interrupción** y las funciones de **captura de comando**. Pueden configurarse desde el editor de código, el depurador o el explorador de ejecución.
+These needs are covered by **breakpoints** and **command catching** features. Pueden configurarse desde el editor de código, el depurador o el explorador de ejecución.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugger.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugger.md
index 2a46d08f191488..1ac6a6b3a84a39 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugger.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugger.md
@@ -47,33 +47,33 @@ La barra de herramientas del depurador incluye varios botones, asociados a acces
Detener el modo Seguimiento y reanudar el curso normal de la ejecución del método.
-> **Shift** + **F5** o **Shift** + clic en el botón **No Trace** retoma la ejecución. También desactiva todas las llamadas a TRACE posteriores en el proceso actual.
+> **Shift** + **F5** or **Shift** + clicking the **No Trace** button resumes execution. También desactiva todas las llamadas a TRACE posteriores en el proceso actual.
#### Pasar por encima
Ejecuta la línea de método actual, indicada por el contador del programa (la flecha amarilla). El depurador pasa a la siguiente línea.
-El botón Ejecutar no entra en las subrutinas y las funciones, sino que se queda al nivel del método que está rastreando en ese momento. Si desea también rastrear las llamadas a las subrutinas y a las funciones, utilice el botón **Paso a paso detallado**.
+El botón Ejecutar no entra en las subrutinas y las funciones, sino que se queda al nivel del método que está rastreando en ese momento. If you want to also trace subroutines and functions calls, use the **Step Into** button.
-En la depuración remota, si el método se ejecuta en el servidor, se llama al método padre después de que se ejecute la última línea del método hijo. Si el método padre se ejecuta en el lado remoto, el botón **Step Over** tiene el mismo efecto que el botón **No Trace**.
+En la depuración remota, si el método se ejecuta en el servidor, se llama al método padre después de que se ejecute la última línea del método hijo. If the parent method is executed on the remote side, the **Step Over** button has the same effect as the **No Trace** button.
#### Paso a paso detallado
Cuando se ejecuta una línea que llama a otro método (subrutina o función), haga clic en este botón para mostrar el otro método y recorrerlo paso a paso.
-El nuevo método se convierte en el método actual (superior) en la [Ventana cadena de llamada ](#call-chain-pane) de la ventana del depurador.
+El nuevo método se convierte en el método actual (superior) en la [Ventana cadena de llamada](#call-chain-pane) de la ventana del depurador.
-Cuando se ejecuta una línea que no llama a otro método, este botón tiene el mismo efecto que el botón **Ejectuar paso a paso**.
+When executing a line that does not call another method, this button has the same effect as the **Step Over** button.
-#### Ejecutar y salir
+#### Step Out
-Si está rastreando subrutinas y funciones, al hacer clic en este botón podrá ejecutar todo el método que se está rastreando en ese momento y retroceder hasta el método llamante. La ventana del depurador vuelve al método anterior de la cadena de llamada. Si el método actual es el último método de la cadena de llamada, se cierra la ventana del depurador.
+If you are tracing subroutines and functions, clicking on this button allows you to execute the entire method currently being traced and to step back to the caller method. The Debugger window is brought back to the previous method in the call chain. If the current method is the last method in the call chain, the Debugger window is closed.
-En la depuración remota, al ejecutarse la última línea del método, si el método se ejecuta en el servidor, se llama al método padre. Si el método padre se ejecuta en el lado remoto, el botón actúa de la misma manera que el botón Reanudar.
+In remote debugging, on execution of the last line of the method, if the method is executed on the server, the parent method is called. If the parent method is executed on the remote side, the button acts in the same manner as the No Trace button.
-#### Paso a paso del nuevo proceso
+#### Step Into Process
-Al ejecutar una línea que crea un nuevo proceso (es decir, al llamar al comando New process), este botón abre una nueva ventana del depurador que permite rastrear el método de gestión del proceso recién creado. En la ejecución de una línea que no crea un nuevo proceso, este botón actúa de la misma manera que el botón Ejecutar paso a paso.
+On execution of a line that creates a new process (i.e., calling the New process command), this button opens a new Debugger window that allows you to trace the process method of the newly created process. On execution of a line that does not creates a new process, this button acts in the same manner as the Step Over button.
#### Abortar
@@ -84,9 +84,9 @@ Detiene la ejecución del método y vuelve al estado anterior al inicio de la ej
#### Detener y editar
-El método que se está ejecutando cuando se presiona el botón **Abortar y Editar** se abre en el Editor de Código.
+The method that is executing when you click the **Abort and Edit** button opens in the Code Editor.
-> **Consejo**: utilice este botón cuando sepa qué cambios son necesarios en su código, y el momento en que deben ser efectuados para proseguir con las pruebas de sus métodos. Una vez haya terminado con los cambios, vuelva a ejecutar el método.
+> **Tip**: Use this button when you know which changes are required in your code, and when these changes are required to pursue the testing of your methods. Una vez haya terminado con los cambios, vuelva a ejecutar el método.
#### Acción de edición
@@ -94,7 +94,7 @@ El método que se está ejecutando en el momento de presionar el botón Editar s
Si utiliza este botón para modificar un método, las modificaciones sólo serán efectivas la próxima vez que se ejecute.
-> **Consejo:** utilice este botón cuando sepa qué cambios son necesarios en su código y cuando no interfieran con el resto del código a ejecutar o rastrear.
+> **Tip:** Use this button when you know which changes are required in your code and when they don't interfere with the rest of the code to be executed or traced.
#### Parámetros Guardar
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md
index c8a06914651a84..3c4fc52b286475 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md
@@ -23,7 +23,7 @@ Sólo un depurador puede depurar una aplicación 4D Server en un momento dado. S
El depurador asociado es llamado cada vez que se encuentra un 4D Server:
- un punto de ruptura
-- un comando `TRACE`
+- a `TRACE` command
- un comando de captura
- un error
@@ -31,7 +31,7 @@ Tenga en cuenta que los mensajes de error se envían a la máquina depuradora as
Note que:
-- El código ejecutado en el método `On Server Startup Database` no se puede depurar de forma remota. Sólo se puede depurar del lado del servidor
+- The code executed in the `On Server Startup Database` Method cannot be debugged remotely. Sólo se puede depurar del lado del servidor
- Si no hay un depurador asociado, el código en ejecución no se detiene con los comandos de depuración
## Asociar al depurador
@@ -47,20 +47,20 @@ Puede asociar el depurador a cualquier cliente 4D remoto que pueda conectarse a
Para asociar el depurador a un cliente 4D remoto:
-1. En la barra de menús de 4D Server, seleccione **Editar** > **Separar depurador** para que el depurador esté disponible para las máquinas remotas (este paso es inútil si 4D Server está funcionando sin interfaz).
-2. En un cliente 4D remoto conectado al servidor, seleccione **Ejecutar** > **Adjuntar depurador remoto**
+1. In the 4D Server menu bar, select **Edit** > **Detach Debugger** so that the debugger becomes available to remote machines (this step is useless if the 4D Server is running headless).
+2. In a remote 4D client connected to the server, select **Run** > **Attach Remote Debugger**
-Si se acepta el archivo adjunto (ver [Solicitudes de archivo adjunto rechazadas](#rejected-attachment-requests)), el comando de menú se convierte en **Desconectar depurador remoto**.
+If the attachment is accepted (see [Rejected attachment requests](#rejected-attachment-requests)), the menu command becomes **Detach Remote Debugger**.
El depurador se conecta entonces al cliente 4D remoto:
- hasta el final de la sesión usuario
-- hasta que se seleccione `Detach Remote Debugger`
+- until you select `Detach Remote Debugger`
Para volver a conectar el depurador al servidor:
-1. En el cliente 4D remoto que tiene el depurador conectado, seleccione **Ejecutar** > **Separar depurador remoto**.
-2. En la barra de menú de 4D Server, seleccione **Editar** > **Adjuntar depurador**.
+1. On the remote 4D client that has the debugger attached, select **Run** > **Detach Remote Debugger**.
+2. In the 4D Server menu bar, select **Edit** > **Attach debugger**.
> Cuando el depurador está conectado al servidor (por defecto), todos los procesos del servidor se ejecutan automáticamente en modo cooperativo para permitir la depuración. Esto puede tener un impacto significativo en el rendimiento. Cuando no necesite depurar en la máquina del servidor, se recomienda separar el depurador y adjuntarlo a una máquina remota si es necesario.
@@ -68,13 +68,13 @@ Para volver a conectar el depurador al servidor:
4D le permite adjuntar automáticamente el depurador a un cliente 4D remoto o al servidor al inicio:
-- En el servidor (si no es headless), esta opción se llama **Attach Debugger At Startup**. Cuando el servidor se inicia, adjunta automáticamente el depurador (por defecto).
+- On the server (if not headless), this option is named **Attach Debugger At Startup**. Cuando el servidor se inicia, adjunta automáticamente el depurador (por defecto).
-> **Advertencia**: si se selecciona esta opción para un servidor que posteriormente se lanza en modo sin interfaz, el depurador no estará disponible para este servidor.
+> **Warning**: If this option is selected for a server which is subsequently launched in headless mode, the debugger won't be available for this server.
-- Asociar al depurador Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Depuradores adjuntos
+- On a remote 4D client, this option is named **Attach Remote Debugger At Startup**. Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. If the attachment is accepted (see [Rejected attachment requests](#rejected-attachment-requests)), the remote debugger is automatically attached to the remote 4D client and the **Detach Remote Debugger option is displayed**.
-> Esta configuración se aplica por proyecto y se almacena localmente en el archivo [`.4DPreferences`](Project/architecture.md#userpreferencesusername).
+> This setting is applied per project and is stored locally in the [`.4DPreferences`](Project/architecture.md#userpreferencesusername) file.
## Peticiones de adjuntos rechazadas
@@ -88,5 +88,5 @@ Si una máquina intenta conectar el depurador cuando ya está conectado, se rech
Adjuntar el depurador en este caso requiere que:
-- el depurador adjunto se separa del servidor o del cliente 4D remoto utilizando respectivamente el comando de menú **Detach debugger** o **Detach remote debugger**,
+- the attached debugger is detached from the server or from the remote 4D client using respectively the **Detach debugger** or **Detach remote debugger** menu command,
- se cierra la sesión del cliente 4D remoto adjunto.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/text.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/text.md
index 38b4a52da42a33..1b8d7c5bc05884 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/text.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/text.md
@@ -47,4 +47,4 @@ Una vez que un texto está rotado, puede seguir cambiando su tamaño o posición
Collection, se utiliza la notación \[ ] para manejar todas las ocurrencias (por ejemplo "niños[ ].edad"). En el caso de una ruta de atributo cuyo tipo es `Collection`, se utiliza la notación `[]` para manejar todas las ocurrencias (por ejemplo `children[].age`).
+- **attributePath**: ruta del atributo sobre el que se quiere ejecutar la búsqueda. Este parámetro puede ser un nombre simple (por ejemplo, "país") o cualquier ruta de atributo válida (por ejemplo, "país.nombre".) En el caso de una ruta de atributo cuyo tipo es `Collection`, se utiliza la notación `[]` para manejar todas las ocurrencias (por ejemplo `children[].age`).
> \*No puede utilizar directamente atributos cuyo nombre contenga caracteres especiales como ".", "\[ ]", o "=", ">", "#"..., porque se evaluarán incorrectamente en la cadena de consulta. Si necesita consultar dichos atributos, debe considerar el uso de marcadores, que permiten un rango ampliado de caracteres en las rutas de los atributos (ver **Uso de marcadores de posición** *a continuación*)
@@ -943,8 +943,8 @@ Las fórmulas en las consultas pueden recibir parámetros a través de $1. Este
| Incluído en | IN | Devuelve los datos iguales a al menos uno de los valores de una colección o de un conjunto de valores, admite el comodín (@) |
| Contiene palabra clave | % | Las palabras claves pueden utilizarse en atributos de tipo texto o imagen |
-- Puede ser un **marcador de posición** (ver **Uso de marcadores de posición** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades. Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20.
- For example, if the string "v20" is entered as value to compare with an integer attribute, it will be converted to 20.
+- **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades. Puede ser un **marcador de posición** (ver **Uso de marcadores de posición** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. Por ejemplo, si se introduce la cadena "v20" como **value** para comparar con un atributo entero, se convertirá a 20. For example, if the string "v20" is entered as value to compare with an integer attribute, it will be converted to 20.
+ Tenga en cuenta que, en caso de no coincidencia de tipo con tipos escalares (texto, fecha, número...), 4D intentará convertir el tipo **value** al tipo de datos del atributo siempre que sea posible, para un manejo más fácil de los valores procedentes de Internet.
- La constante de tipo **texto** puede pasarse con o sin comillas simples (ver **Uso de comillas** más abajo). Para consultar una cadena dentro de otra cadena (una consulta de tipo "contiene"), utilice el símbolo de comodín (@) en el valor para aislar la cadena a buscar como se muestra en este ejemplo: "@Smith@". Las siguientes palabras claves están prohibidas para las constantes de texto: true, false.
- Valores constantes de tipo **booleano**: **true** o **false** (Sensible a las mayúsculas y minúsculas).
- Valores constantes de **tipo numérico**: los decimales se separan con un '.' (punto).
@@ -1038,6 +1038,20 @@ No obtendrá el resultado esperado porque el valor null será evaluado por 4D co
$vSingles:=ds.Person.query("spouse = null") // Sintaxis correcta
```
+#### Not equal to null or undefined values
+
+The "not equal to *value*" comparator (`#` or `!=`) does not return attributes whose value is null or undefined. For example, the following query will only return persons whose "info.married" status is `false` and not persons whose "info.married" property is "null" or missing:
+
+```4d
+$notMarried:=ds.Person.query("info.married#true") //finds persons with attribute value is false
+```
+
+If you want to find persons whose "info.married" status is `false`, null, or not defined, you need to write:
+
+```4d
+$notMarried:=ds.Person.query("info.married#true | info.married=null") //finds false, null and undefined attributes
+```
+
#### No igual a en colecciones
Al buscar dentro de atributos de objetos de dataclass que contengan las colecciones, el comparador "not equal to *value*" (`#` o `!=`) encontrará los elementos en los que TODAS las propiedades sean diferentes de *value* (y no aquellos en los que AL MENOS una propiedad sea diferente de *value*, que es como funcionan otros comparadores). Básicamente, equivale a buscar "Not(buscar elementos de la colección cuya propiedad sea igual a *value*"). Por ejemplo, con las siguientes entidades:
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md
index 8146ef0595bc28..0e72b0ec7d25eb 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md
@@ -102,7 +102,7 @@ La función `.clone()` crea en la memor
This function allows you to update entities separately. Note however that, for performance reasons, the new entity shares the same reference of object attributes as the cloned entity.
-> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed.
+> Tenga en cuenta que toda modificación realizada a las entidades se guardará en el registro referenciado sólo cuando se ejecute la función [`.save()`](#save).
Esta función sólo puede utilizarse con entidades ya guardadas en la base de datos. No se puede llamar a una entidad recién creada (para la que [`isNew()`](#isnew) devuelve **True**).
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md
index 4ff1cc8e2e3d29..6afe62d3120507 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md
@@ -5,7 +5,7 @@ title: OutgoingMessage
The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class.
-Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser.
+Típicamente, esta clase puede ser usada en funciones declaradas con la palabra clave [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) y diseñadas para manejar las peticiones HTTP GET. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser.
An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile).
@@ -61,7 +61,7 @@ A 4D.OutgoingMessage object is a [non-sharable](../Concepts/shared.md) object.
#### Descripción
-The `.body` property contains the outgoing message body. The following data types are supported in the `.body` property:
+La propiedad `.body` contiene el cuerpo del mensaje saliente. The following data types are supported in the `.body` property:
- text
- blob
@@ -70,7 +70,7 @@ The `.body` property contains the
La propiedad `.body` es de lectura-escritura.
-You can also set the `.body` property using the [`setBody()`](#setbody) function, in which case the `content-type` header is automatically set.
+También puede definir la propiedad `.body` utilizando la función [`setBody()`](#setbody), en cuyo caso el encabezado `content-type` se define automáticamente.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/SignalClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/SignalClass.md
index ab6418eaee23f2..573fca674ee900 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/SignalClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/SignalClass.md
@@ -22,7 +22,7 @@ Lanzamiento Mientras espera una señal, el proceso que llama no utiliza ninguna
Tenga en cuenta que para evitar situaciones de bloqueo, el método `.wait()` también puede regresar después de que se haya alcanzado un tiempo de espera definido.
-Los objetos señal se crean con el comando [`New signal`](../commands/new-signal.md).
+Los objetos Signal se crean con el comando [`New signal`](../commands/new-signal.md).
### Trabajar con señales
@@ -126,7 +126,7 @@ Esta propiedad está en **lectura-escritura**.
#### Descripción
-Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`.
+Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`.
Esta propiedad es de **solo lectura**.
@@ -158,7 +158,7 @@ Esta propiedad es de **solo lectura**.
La función `.trigger( )` define la propiedad `signaled` del objeto signal como **true** y despierta a todos los workers o procesos que esperan esta signal.
-Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\\\\\` ya es **true**), la función no hace nada.
+Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\\\\\\\\` ya es **true**), la función no hace nada.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/basics.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/basics.md
index 73a474557f624c..f71990358b5253 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/basics.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/basics.md
@@ -70,27 +70,27 @@ La ventana de error de sintaxis propone varias opciones:
- **Continuar**: la ejecución continua. La línea con el error puede ser parcialmente ejecutada, dependiendo de donde se encuentre el error. Continúe con precaución: el error puede impedir que el resto de su método se ejecute correctamente. Recomendamos hacer clic en **Continuar** sólo si el error está en una llamada trivial (como `SET WINDOW TITLE`) que no impide ejecutar y probar el resto de su código.
-> Consejo: para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede convertir el botón **Continuar** en un botón **Ignorar**. Mantenga presionada la tecla **Alt** (Windows) u **Opción** (macOS) y haga clic en el botón **Continuar** la primera vez que aparece. La etiqueta del botón cambia a **Ignorar** si el diálogo es llamado de nuevo por el mismo error.
+> Consejo: para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede convertir el botón **Continuar** en un botón **Ignorar**. Hold down **Alt** (Windows) or **Option** (macOS) key and click the **Continue** button the first time it appears. The button label changes to **Ignore** if the dialog is called again for the same error.
-- **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método:
+- **Abort**: Stops method execution and returns to the state before the method started executing:
- Si un método formulario o método objeto se está ejecutando en respuesta a un evento, se detiene y se vuelve al formulario.
- Si el método se está ejecutando desde dentro del entorno de la aplicación, volverá a ese entorno.
-- **Copiar**: copia la información de depuración en el portapapeles. La información describe el entorno interno del error (número, componente interno, etc.). Está formateado como texto tabulado.
+- **Copy**: Copies the debugging information into the clipboard. La información describe el entorno interno del error (número, componente interno, etc.). Está formateado como texto tabulado.
-- **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`.
+- **Save...**: Saves the contents of the syntax error window and the call chain in a `.txt` file.
## Debugger
-Un error común de los principiantes al tratar con la detección de errores es hacer clic en **Abandonar** en la ventana de error de sintaxis, volver al editor de código, y tratar de averiguar lo que está pasando mirando el código. ¡No lo haga! Ahorrará mucho tiempo y energía utilizando siempre el **Depurador**.
+A common beginner mistake in dealing with error detection is to click **Abort** in the Syntax Error Window, go back to the Code Editor, and try to figure out what's going by looking at the code. ¡No lo haga! Ahorrará mucho tiempo y energía utilizando siempre el **Depurador**.
El depurador le permite pasar lentamente por los métodos. Muestra toda la información que necesita para entender por qué ha ocurrido un error. Una vez que tiene esta información, usted sabe cómo arreglar el error.
-Otra razón para usar el Depurador es el desarrollo del código. A veces se puede escribir un algoritmo que es más complejo de lo habitual. A pesar de todos los sentimientos de cumplimiento, no puede estar totalmente seguro de que su codificación sea 100% correcta. En lugar de ejecutarlo "ciego", puede utilizar el comando `TRACE` al comienzo de su código, luego ejecutarlo paso a paso para mantener un ojo en lo que sucede.
+Otra razón para usar el Depurador es el desarrollo del código. A veces se puede escribir un algoritmo que es más complejo de lo habitual. A pesar de todos los sentimientos de cumplimiento, no puede estar totalmente seguro de que su codificación sea 100% correcta. Instead of running it "blind", you can use the `TRACE` command at the beginning of your code, then execute it step by step to keep an eye on what happens.
## Rupturas
En el proceso de depuración, puede que necesite saltar el seguimiento de algunas partes del código hasta una línea determinada. O, puede querer rastrear el código cuando una expresión dada tiene un determinado valor (e.. "$myVar > 1000"), o cada vez que se llama un comando 4D específico.
-Estas necesidades están cubiertas por **puntos de interrupción** y las funciones de **captura de comando**. Pueden configurarse desde el editor de código, el depurador o el explorador de ejecución.
+These needs are covered by **breakpoints** and **command catching** features. Pueden configurarse desde el editor de código, el depurador o el explorador de ejecución.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md
index 27f0d1d6345754..7792aaebed00b1 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md
@@ -52,33 +52,33 @@ La barra de herramientas del depurador incluye varios botones, asociados a acces
Detener el modo Seguimiento y reanudar el curso normal de la ejecución del método.
-> **Shift** + **F5** o **Shift** + clic en el botón **No Trace** retoma la ejecución. También desactiva todas las llamadas a TRACE posteriores en el proceso actual.
+> **Shift** + **F5** or **Shift** + clicking the **No Trace** button resumes execution. También desactiva todas las llamadas a TRACE posteriores en el proceso actual.
#### Pasar por encima
Ejecuta la línea de método actual, indicada por el contador del programa (la flecha amarilla). El depurador pasa a la siguiente línea.
-El botón Ejecutar no entra en las subrutinas y las funciones, sino que se queda al nivel del método que está rastreando en ese momento. Si desea también rastrear las llamadas a las subrutinas y a las funciones, utilice el botón **Paso a paso detallado**.
+El botón Ejecutar no entra en las subrutinas y las funciones, sino que se queda al nivel del método que está rastreando en ese momento. If you want to also trace subroutines and functions calls, use the **Step Into** button.
-En la depuración remota, si el método se ejecuta en el servidor, se llama al método padre después de que se ejecute la última línea del método hijo. Si el método padre se ejecuta en el lado remoto, el botón **Step Over** tiene el mismo efecto que el botón **No Trace**.
+En la depuración remota, si el método se ejecuta en el servidor, se llama al método padre después de que se ejecute la última línea del método hijo. If the parent method is executed on the remote side, the **Step Over** button has the same effect as the **No Trace** button.
#### Paso a paso detallado
Cuando se ejecuta una línea que llama a otro método (subrutina o función), haga clic en este botón para mostrar el otro método y recorrerlo paso a paso.
-El nuevo método se convierte en el método actual (superior) en la [Ventana cadena de llamada ](#call-chain-pane) de la ventana del depurador.
+El nuevo método se convierte en el método actual (superior) en la [Ventana cadena de llamada](#call-chain-pane) de la ventana del depurador.
-Cuando se ejecuta una línea que no llama a otro método, este botón tiene el mismo efecto que el botón **Ejectuar paso a paso**.
+When executing a line that does not call another method, this button has the same effect as the **Step Over** button.
-#### Ejecutar y salir
+#### Step Out
-Si está rastreando subrutinas y funciones, al hacer clic en este botón podrá ejecutar todo el método que se está rastreando en ese momento y retroceder hasta el método llamante. La ventana del depurador vuelve al método anterior de la cadena de llamada. Si el método actual es el último método de la cadena de llamada, se cierra la ventana del depurador.
+If you are tracing subroutines and functions, clicking on this button allows you to execute the entire method currently being traced and to step back to the caller method. The Debugger window is brought back to the previous method in the call chain. If the current method is the last method in the call chain, the Debugger window is closed.
-En la depuración remota, al ejecutarse la última línea del método, si el método se ejecuta en el servidor, se llama al método padre. Si el método padre se ejecuta en el lado remoto, el botón actúa de la misma manera que el botón Reanudar.
+In remote debugging, on execution of the last line of the method, if the method is executed on the server, the parent method is called. If the parent method is executed on the remote side, the button acts in the same manner as the No Trace button.
-#### Paso a paso del nuevo proceso
+#### Step Into Process
-Al ejecutar una línea que crea un nuevo proceso (es decir, al llamar al comando New process), este botón abre una nueva ventana del depurador que permite rastrear el método de gestión del proceso recién creado. En la ejecución de una línea que no crea un nuevo proceso, este botón actúa de la misma manera que el botón Ejecutar paso a paso.
+On execution of a line that creates a new process (i.e., calling the New process command), this button opens a new Debugger window that allows you to trace the process method of the newly created process. On execution of a line that does not creates a new process, this button acts in the same manner as the Step Over button.
#### Abortar
@@ -89,9 +89,9 @@ Detiene la ejecución del método y vuelve al estado anterior al inicio de la ej
#### Detener y editar
-El método que se está ejecutando cuando se presiona el botón **Abortar y Editar** se abre en el Editor de Código.
+The method that is executing when you click the **Abort and Edit** button opens in the Code Editor.
-> **Consejo**: utilice este botón cuando sepa qué cambios son necesarios en su código, y el momento en que deben ser efectuados para proseguir con las pruebas de sus métodos. Una vez haya terminado con los cambios, vuelva a ejecutar el método.
+> **Tip**: Use this button when you know which changes are required in your code, and when these changes are required to pursue the testing of your methods. Una vez haya terminado con los cambios, vuelva a ejecutar el método.
#### Acción de edición
@@ -99,7 +99,7 @@ El método que se está ejecutando en el momento de presionar el botón Editar s
Si utiliza este botón para modificar un método, las modificaciones sólo serán efectivas la próxima vez que se ejecute.
-> **Consejo:** utilice este botón cuando sepa qué cambios son necesarios en su código y cuando no interfieran con el resto del código a ejecutar o rastrear.
+> **Tip:** Use this button when you know which changes are required in your code and when they don't interfere with the rest of the code to be executed or traced.
#### Parámetros Guardar
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md
index 484587e09605c9..a62eb0f424ee27 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md
@@ -24,7 +24,7 @@ Sólo un depurador puede depurar una aplicación 4D Server en un momento dado. S
El depurador asociado es llamado cada vez que se encuentra un 4D Server:
- un punto de ruptura
-- un comando `TRACE`
+- a `TRACE` command
- un comando de captura
- un error
@@ -32,7 +32,7 @@ Tenga en cuenta que los mensajes de error se envían a la máquina depuradora as
Note que:
-- El código ejecutado en el método `On Server Startup Database` no se puede depurar de forma remota. Sólo se puede depurar del lado del servidor
+- The code executed in the `On Server Startup Database` Method cannot be debugged remotely. Sólo se puede depurar del lado del servidor
- Si no hay un depurador asociado, el código en ejecución no se detiene con los comandos de depuración
## Asociar al depurador
@@ -48,20 +48,20 @@ Puede asociar el depurador a cualquier cliente 4D remoto que pueda conectarse a
Para asociar el depurador a un cliente 4D remoto:
-1. En la barra de menús de 4D Server, seleccione **Editar** > **Separar depurador** para que el depurador esté disponible para las máquinas remotas (este paso es inútil si 4D Server está funcionando sin interfaz).
-2. En un cliente 4D remoto conectado al servidor, seleccione **Ejecutar** > **Adjuntar depurador remoto**
+1. In the 4D Server menu bar, select **Edit** > **Detach Debugger** so that the debugger becomes available to remote machines (this step is useless if the 4D Server is running headless).
+2. In a remote 4D client connected to the server, select **Run** > **Attach Remote Debugger**
-Si se acepta el archivo adjunto (ver [Solicitudes de archivo adjunto rechazadas](#rejected-attachment-requests)), el comando de menú se convierte en **Desconectar depurador remoto**.
+If the attachment is accepted (see [Rejected attachment requests](#rejected-attachment-requests)), the menu command becomes **Detach Remote Debugger**.
El depurador se conecta entonces al cliente 4D remoto:
- hasta el final de la sesión usuario
-- hasta que se seleccione `Detach Remote Debugger`
+- until you select `Detach Remote Debugger`
Para volver a conectar el depurador al servidor:
-1. En el cliente 4D remoto que tiene el depurador conectado, seleccione **Ejecutar** > **Separar depurador remoto**.
-2. En la barra de menú de 4D Server, seleccione **Editar** > **Adjuntar depurador**.
+1. On the remote 4D client that has the debugger attached, select **Run** > **Detach Remote Debugger**.
+2. In the 4D Server menu bar, select **Edit** > **Attach debugger**.
> Cuando el depurador está conectado al servidor (por defecto), todos los procesos del servidor se ejecutan automáticamente en modo cooperativo para permitir la depuración. Esto puede tener un impacto significativo en el rendimiento. Cuando no necesite depurar en la máquina del servidor, se recomienda separar el depurador y adjuntarlo a una máquina remota si es necesario.
@@ -69,13 +69,13 @@ Para volver a conectar el depurador al servidor:
4D le permite adjuntar automáticamente el depurador a un cliente 4D remoto o al servidor al inicio:
-- En el servidor (si no es headless), esta opción se llama **Attach Debugger At Startup**. Cuando el servidor se inicia, adjunta automáticamente el depurador (por defecto).
+- On the server (if not headless), this option is named **Attach Debugger At Startup**. Cuando el servidor se inicia, adjunta automáticamente el depurador (por defecto).
-> **Advertencia**: si se selecciona esta opción para un servidor que posteriormente se lanza en modo sin interfaz, el depurador no estará disponible para este servidor.
+> **Warning**: If this option is selected for a server which is subsequently launched in headless mode, the debugger won't be available for this server.
-- Asociar al depurador Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Depuradores adjuntos
+- On a remote 4D client, this option is named **Attach Remote Debugger At Startup**. Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. If the attachment is accepted (see [Rejected attachment requests](#rejected-attachment-requests)), the remote debugger is automatically attached to the remote 4D client and the **Detach Remote Debugger option is displayed**.
-> Esta configuración se aplica por proyecto y se almacena localmente en el archivo [`.4DPreferences`](Project/architecture.md#userpreferencesusername).
+> This setting is applied per project and is stored locally in the [`.4DPreferences`](Project/architecture.md#userpreferencesusername) file.
## Peticiones de adjuntos rechazadas
@@ -89,5 +89,5 @@ Si una máquina intenta conectar el depurador cuando ya está conectado, se rech
Adjuntar el depurador en este caso requiere que:
-- el depurador adjunto se separa del servidor o del cliente 4D remoto utilizando respectivamente el comando de menú **Detach debugger** o **Detach remote debugger**,
+- the attached debugger is detached from the server or from the remote 4D client using respectively the **Detach debugger** or **Detach remote debugger** menu command,
- se cierra la sesión del cliente 4D remoto adjunto.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/text.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/text.md
index 38b4a52da42a33..1b8d7c5bc05884 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/text.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/text.md
@@ -47,4 +47,4 @@ Una vez que un texto está rotado, puede seguir cambiando su tamaño o posición
ds コマンドによって返されます。
+開かれている 4Dデータベース (シングルユーザーまたはクライアント/サーバー) に対応するデータストアオブジェクト。 メインデータストアは ds コマンドによって返されます。 メインデータストアは ds コマンドによって返されます。 メインデータストアは ds コマンドによって返されます。 メインデータストアは ds コマンドによって返されます。
## メソッド
-データストア、データクラス、エンティティセレクション、エンティティなどの ORDA オブジェクトは、オブジェクトのクラスを定義します。 これらのクラスには、オブジェクトを直接操作するための専用のメソッドが提供されています。 これらのメソッドはメンバー関数とも呼ばれます。 このメソッドを使用するには、オブジェクトのインスタンスに対して呼び出します。
+データストア、データクラス、エンティティセレクション、エンティティなどの ORDA オブジェクトは、オブジェクトのクラスを定義します。 これらのクラスには、オブジェクトを直接操作するための専用のメソッドが提供されています。 これらのメソッドはメンバー関数とも呼ばれます。 このメソッドを使用するには、オブジェクトのインスタンスに対して呼び出します。 これらのクラスには、オブジェクトを直接操作するための専用のメソッドが提供されています。 これらのメソッドはメンバー関数とも呼ばれます。 このメソッドを使用するには、オブジェクトのインスタンスに対して呼び出します。
-たとえば、`query()` メソッドはデータクラスのメンバー関数です。 `$myClass` 変数にデータクラスオブジェクトを格納している場合、次のように書くことができます:
+たとえば、`query()` メソッドはデータクラスのメンバー関数です。 たとえば、`query()` メソッドはデータクラスのメンバー関数です。 たとえば、`query()` メソッドはデータクラスのメンバー関数です。 `$myClass` 変数にデータクラスオブジェクトを格納している場合、次のように書くことができます: たとえば、`query()` メソッドはデータクラスのメンバー関数です。 たとえば、`query()` メソッドはデータクラスのメンバー関数です。 `$myClass` 変数にデータクラスオブジェクトを格納している場合、次のように書くことができます:
```code4d
$myClass.query("name = smith")
@@ -127,7 +127,7 @@ $myClass.query("name = smith")
## ミックスデータ型
-このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 :
+このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : : : :
- 数値
- text
@@ -156,11 +156,11 @@ _(\*) ピクチャー型は_ `entitySelection.max( )` _などの統計型メソ
[属性](#属性) を参照してください。
-> 属性とプロパティは似た概念です。 "属性" はデータを保存するデータクラスプロパティを指定するのに使われるのに対し、"プロパティ"はより一般的な概念でオブジェクト内で保存されるデータを定義します。
+> 属性とプロパティは似た概念です。 _属性_ と _プロパティ_ は似た概念です。 "属性" はデータを保存するデータクラスプロパティを指定するのに使われるのに対し、"プロパティ"はより一般的な概念でオブジェクト内で保存されるデータを定義します。
## プロパティパス
-プロパティパスとは、あるオブジェクトのプロパティへのパスです。 プロパティが複数の階層にネストされている場合、各階層はドット (".") によって区切られます。
+属性パスとは、あるデータクラスあるいはエンティティ内の属性へのパスです。 [プロパティパス](#プロパティパス) も参照ください。 プロパティが複数の階層にネストされている場合、各階層はドット (".") によって区切られます。
## 通常クラス
@@ -189,23 +189,23 @@ ORDA オブジェクトとは関わりのないユーザークラス。
## リモートデータストア
-4D または (HTTP経由で利用可能な) 4D Server 上で開かれている、REST リソースとして公開された 4Dデータベース。 このデータベースは他のマシンにおいてデータストアとしてローカルに参照することができ、その際には割り当てられた locaID で識別されます。 リモートデータストアは ORDA の概念 (データストア、データクラス、エンティティセレクション等) を使って利用できます。 利用にあたってはライセンスが消費されます。
+4D または (HTTP経由で利用可能な) 4D Server 上で開かれている、REST リソースとして公開された 4Dデータベース。 このデータベースは他のマシンにおいてデータストアとしてローカルに参照することができ、その際には割り当てられた locaID で識別されます。 リモートデータストアは ORDA の概念 (データストア、データクラス、エンティティセレクション等) を使って利用できます。 利用にあたってはライセンスが消費されます。 このデータベースは他のマシンにおいてデータストアとしてローカルに参照することができ、その際には割り当てられた locaID で識別されます。 リモートデータストアは ORDA の概念 (データストア、データクラス、エンティティセレクション等) を使って利用できます。 利用にあたってはライセンスが消費されます。
## リソース
-[権限](#権限) における [アクション](#アクション) の許可・拒否の対象となる ORDA 要素。 利用可能なリソースは、データストア、データクラス、データクラス属性、ORDAデータモデル関数のいずれかです。
+[権限](#権限) における [アクション](#アクション) の許可・拒否の対象となる ORDA 要素。 利用可能なリソースは、データストア、データクラス、データクラス属性、ORDAデータモデル関数のいずれかです。 利用可能なリソースは、データストア、データクラス、データクラス属性、ORDAデータモデル関数のいずれかです。
## ロール
-ロールとは、管理者が使用することを目的とした、公開された [権限](#権限) のことです。 ロールは 1つ以上の権限を持つことができます。
+ロールとは、管理者が使用することを目的とした、公開された [権限](#権限) のことです。 ロールは 1つ以上の権限を持つことができます。 ロールは 1つ以上の権限を持つことができます。 ロールは 1つ以上の権限を持つことができます。
## セッション
-4Dアプリケーションがリモートデータストアに接続すると、4D Server (HTTP) 上では セッション が作成されます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。
+4Dアプリケーションがリモートデータストアに接続すると、4D Server (HTTP) 上では セッション が作成されます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。
-新規セッションが開始されるごとに、ライセンスが消費されます。 セッションが閉じられると、ライセンスは解放されます。
+新規セッションが開始されるごとに、ライセンスが消費されます。 セッションが閉じられると、ライセンスは解放されます。 セッションが閉じられると、ライセンスは解放されます。 セッションが閉じられると、ライセンスは解放されます。 セッションが閉じられると、ライセンスは解放されます。
-アクティビティのないセッションはタイムアウト後に自動的に終了します。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。
+アクティビティのないセッションはタイムアウト後に自動的に終了します。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。
## シャロウコピー
@@ -217,4 +217,4 @@ ORDA オブジェクトとは関わりのないユーザークラス。
## ストレージ属性
-ストレージ属性 (スカラー属性と呼ばれることも) は、データストアクラスの属性の中で最も基本的なタイプであり、リレーショナルデータベースのフィールドに最も直接的に対応するものです。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。
+ストレージ属性 (スカラー属性と呼ばれることも) は、データストアクラスの属性の中で最も基本的なタイプであり、リレーショナルデータベースのフィールドに最も直接的に対応するものです。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md
index 87194921d8670d..82589101d395e8 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md
@@ -3,13 +3,13 @@ id: privileges
title: 権限
---
-データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 ORDA のセキュリティアーキテクチャーはデータストアの中心に実装されており、プロジェクト内のさまざまなリソース (データストア、データクラス、関数など) に対して、すべての Web または REST ユーザーセッションに特定の権限を定義することができます。
+データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 ORDA のセキュリティアーキテクチャーはデータストアの中心に実装されており、プロジェクト内のさまざまなリソース (データストア、データクラス、関数など) に対して、すべての Web または REST ユーザーセッションに特定の権限を定義することができます。
## 概要
ORDA のセキュリティアーキテクチャーは、権限、許諾アクション (read、create など)、およびリソースの概念に基づいています。
-Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。
+Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。
セッション内で送信されるユーザーリクエストは、プロジェクトの `roles.json` ファイルで定義された権限に対して評価されます。
@@ -36,12 +36,12 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ
あるレベルにおいて定義されたパーミッションは基本的に下位レベルに継承されますが、パーミッションは複数のレベルで設定することもできます:
- データストアレベルで定義されたパーミッションは、自動的にすべてのデータクラスに割り当てられます。
-- データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。
-- データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。
+- データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。
+- データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。 データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。 データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。
:::info
-パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。 特定の条件に基づいて読み取りデータをフィルタリングしたい場合は、[制限付エンティティセレクション](entities.md#制限付エンティティセレクション) の利用がより適切かもしれません。
+パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。 パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。 特定の条件に基づいて読み取りデータをフィルタリングしたい場合は、[制限付エンティティセレクション](entities.md#制限付エンティティセレクション) の利用がより適切かもしれません。
:::
@@ -49,15 +49,14 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ
利用可能なアクションは対象となるリソースによります。
-| アクション | データストア | データクラス | 属性 | データモデル関数またはシングルトン関数 |
-| ------------ | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| **create** | 任意のデータクラスにおいてエンティティを作成 | 当該データクラスにおいてエンティティを作成 | 当該属性に許可されたデフォルト値とは異なる値を持つエンティティを作成 (エイリアス属性の場合は無視されます) | n/a |
-| **read** | 任意のデータクラスにおいて属性を読み取り | 当該データクラスにおいて属性を読み取り | 当該属性を読み取り | n/a |
-| **update** | 任意のデータクラスにおいて属性を更新 | 当該データクラスにおいて属性を更新 | 当該属性を更新 (エイリアス属性の場合は無視されます) | n/a |
-| **drop** | 任意のデータクラスにおいてデータを削除 | 当該データクラスにおいてデータを削除 | 当該属性の null でない値を削除 (エイリアス属性と計算属性を除く) | n/a |
-| **execute** | プロジェクトの任意の関数を実行 (データストア、データクラス、エンティティセレクション、エンティティ) | データクラスの任意の関数を実行。 データクラス関数、エンティティ関数、エンティティセレクション関数は、データクラスの関数として扱われます。 | n/a | 当該関数を実行 |
-| **describe** | /rest/$catalog API ですべてのデータクラスが利用可能 | /rest/$catalog API で当該データクラスが利用可能 | /rest/$catalog API で当該属性が利用可能 | /rest/$catalog API で当該データクラス関数が利用可能 (シングルトン関数は利用できません) |
-| **promote** | n/a | n/a | n/a | 関数の実行に指定の権限を関連付けます。 権限は一時的にセッションに追加され、関数の実行終了とともに削除されます。 セキュリティ上、セッション全体ではなく、当該関数を実行するプロセスのみに権限が追加されます。 |
+| アクション | データストア | データクラス | 属性 | データモデル関数またはシングルトン関数 |
+| ----------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **create** | 任意のデータクラスにおいてエンティティを作成 | 当該データクラスにおいてエンティティを作成 | 当該属性に許可されたデフォルト値とは異なる値を持つエンティティを作成 (エイリアス属性の場合は無視されます) | n/a |
+| **read** | 任意のデータクラスにおいて属性を読み取り | 当該データクラスにおいて属性を読み取り | 当該属性を読み取り | n/a |
+| **update** | 任意のデータクラスにおいて属性を更新 | 当該データクラスにおいて属性を更新 | 当該属性を更新 (エイリアス属性の場合は無視されます) | n/a |
+| **drop** | 任意のデータクラスにおいてデータを削除 | 当該データクラスにおいてデータを削除 | 当該属性の null でない値を削除 (エイリアス属性と計算属性を除く) | n/a |
+| **execute** | プロジェクトの任意の関数を実行 (データストア、データクラス、エンティティセレクション、エンティティ) | データクラスの任意の関数を実行。 データクラスの任意の関数を実行。 データクラスの任意の関数を実行。 データクラスの任意の関数を実行。 データクラス関数、エンティティ関数、エンティティセレクション関数は、データクラスの関数として扱われます。 | n/a | 当該関数を実行 |
+| **promote** | n/a | n/a | n/a | 関数の実行に指定の権限を関連付けます。 権限は一時的にセッションに追加され、関数の実行終了とともに削除されます。 関数の実行に指定の権限を関連付けます。 権限は一時的にセッションに追加され、関数の実行終了とともに削除されます。 セキュリティ上、セッション全体ではなく、当該関数を実行するプロセスのみに権限が追加されます。 |
**注:**
@@ -67,18 +66,15 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ
- デフォルト値: 現在の実装では、_Null_ のみデフォルト値として利用可能です。
- REST の [強制ログインモード](../REST/authUsers.md/#強制ログインモード) では、[`authentify()`関数](../REST/authUsers.md#function-authentify) は、権限の設定に関係なく常にゲストユーザーによって実行可能です。
-許諾の設定は一貫している必要があります。とくに:
-
-- **update** および **drop** アクションには **read** が必要です (**create** には不要です)
-- データモデル関数の場合、**promote** アクションには **describe** が必要です。
+Setting permissions requires to be consistent, in particular **update** and **drop** permissions also need **read** permission (but **create** does not need it).
## 権限とロール
-**権限** とは、**リソース** に対して **アクション** を実行する技術的な能力であり、**ロール** は、管理者が使用するために公開された権限のことです。 基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。 たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。
+**権限** とは、**リソース** に対して **アクション** を実行する技術的な能力であり、**ロール** は、管理者が使用するために公開された権限のことです。 基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。 たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。 基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。 たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。
権限は、複数の "リソース+アクション" の組み合わせと関連付けることができます。 また、一つのアクションに複数の権限を関連付けることができます。 権限は、他の権限を含むことができます。
-- 権限やロールの **作成** は `roles.json` ファイル内にておこないます (後述参照)。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。
+- 権限やロールの **作成** は `roles.json` ファイル内にておこないます (後述参照)。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。
- 各ユーザーセッションに権限やロールを **許可** するには、`Session` クラスの [`.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数を使用します。
@@ -140,7 +136,6 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T
"create": ["none"],
"update": ["none"],
"drop": ["none"],
- "describe": ["none"],
"execute": ["none"],
"promote": ["none"]
}
@@ -153,17 +148,20 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T
```
-最高レベルのセキュリティのため、データストア ("ds") のすべての許諾アクションに "none" の権限名が割り当てられています。したがって、デフォルトでは `ds` オブジェクト全体へのデータアクセスが無効になっています。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。
+最高レベルのセキュリティのため、データストア ("ds") のすべての許諾アクションに "none" の権限名が割り当てられています。したがって、デフォルトでは `ds` オブジェクト全体へのデータアクセスが無効になっています。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。
:::caution
-`roles.json` ファイルに特定のパラメーターが定義されていない場合、アクセスは制限されません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。
+`roles.json` ファイルに特定のパラメーターが定義されていない場合、アクセスは制限されません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。
:::
:::note 互換性
-以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 4D 20 R6 以降、`roles.json`ファイルを含まない、または `"forceLogin": true` の設定が含まれていない既存のプロジェクトを開く場合、[設定ダイアログボックスの **Web機能** ページ](../settings/web.md#アクセス権) で **ds.authentify() 関数を通しての REST認証を有効化** ボタンが利用可能になります。 このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 4D 20 R6 以降、`roles.json`ファイルを含まない、または `"forceLogin": true` の設定が含まれていない既存のプロジェクトを開く場合、[設定ダイアログボックスの **Web機能** ページ](../settings/web.md#アクセス権) で **ds.authentify() 関数を通しての REST認証を有効化** ボタンが利用可能になります。 このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+::: このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+::: このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+::: このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
:::
:::note Qodly Studio
@@ -176,41 +174,40 @@ Qodly Studio for 4D では、権限パネルの [**強制ログイン**オプシ
`roles.json` ファイルの構文は次のとおりです:
-| プロパティ名 | | | 型 | 必須 | 説明 |
-| ----------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------ |
-| privileges | | | `privilege` オブジェクトの Collection | ○ | 定義された権限のリスト |
-| | \[].privilege | | Text | | アクセス権の名称 |
-| | \[].includes | | String の Collection | | 内包する権限名のリスト |
-| roles | | | `role` オブジェクトの Collection | | 定義されたロールのリスト |
-| | \[].role | | Text | | ロール名 |
-| | \[].privileges | | String の Collection | | 内包する権限名のリスト |
-| permissions | | | Object | ○ | 設定されたパーミッションのリスト |
-| | allowed | | `permission` オブジェクトの Collection | | 許可されたパーミッションのリスト |
-| | | \[].applyTo | Text | ○ | 対象の [リソース](#リソース) 名 |
-| | | \[].type | Text | ○ | [リソース](#リソース) タイプ: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" |
-| | | \[].read | String の Collection | | 権限名のリスト |
-| | | \[].create | String の Collection | | 権限名のリスト |
-| | | \[].update | String の Collection | | 権限名のリスト |
-| | | \[].drop | String の Collection | | 権限名のリスト |
-| | | \[].describe | String の Collection | | 権限名のリスト |
-| | | \[].execute | String の Collection | | 権限名のリスト |
-| | | \[].promote | String の Collection | | 権限名のリスト |
-| forceLogin | | | Boolean | | ["forceLogin" モード](../REST/authUsers.md#force-login-mode) を有効にする場合は true |
+| プロパティ名 | | | 型 | 必須 | 説明 |
+| ----------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------ |
+| privileges | | | `privilege` オブジェクトの Collection | ○ | 定義された権限のリスト |
+| | \[].privilege | | Text | | アクセス権の名称 |
+| | \[].includes | | String の Collection | | 内包する権限名のリスト |
+| roles | | | `role` オブジェクトの Collection | | 定義されたロールのリスト |
+| | \[].role | | Text | | ロール名 |
+| | \[].privileges | | String の Collection | | 内包する権限名のリスト |
+| permissions | | | Object | ○ | 設定されたパーミッションのリスト |
+| | allowed | | `permission` オブジェクトの Collection | | 許可されたパーミッションのリスト |
+| | | \[].applyTo | Text | ○ | 対象の [リソース](#リソース) 名 |
+| | | \[].type | Text | ○ | [リソース](#リソース) タイプ: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" |
+| | | \[].read | String の Collection | | 権限名のリスト |
+| | | \[].create | String の Collection | | 権限名のリスト |
+| | | \[].update | String の Collection | | 権限名のリスト |
+| | | \[].drop | String の Collection | | 権限名のリスト |
+| | | \[].execute | String の Collection | | 権限名のリスト |
+| | | \[].promote | String の Collection | | 権限名のリスト |
+| forceLogin | | | Boolean | | ["forceLogin" モード](../REST/authUsers.md#force-login-mode) を有効にする場合は true |
:::caution 注記
-- "WebAdmin" 権限名は、アプリケーションによって予約されています。 この名前をカスタムの権限名に使用することは推奨されません。
+- "WebAdmin" 権限名は、アプリケーションによって予約されています。 この名前をカスタムの権限名に使用することは推奨されません。 この名前をカスタムの権限名に使用することは推奨されません。 この名前をカスタムの権限名に使用することは推奨されません。 この名前をカスタムの権限名に使用することは推奨されません。
- `privileges` および `roles` の名称においては文字の大小が区別されます。
:::
### `Roles_Errors.json` ファイル
-`roles.json` ファイルは、4D 起動時に解析されます。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。
+`roles.json` ファイルは、4D 起動時に解析されます。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。
-`roles.json` ファイルを解析する際にエラーが発生した場合、4D はプロジェクトを読み込みますが、グローバルアクセス保護は無効になります。これにより、開発者はエラー修正のためファイルにアクセスすることができます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。
+`roles.json` ファイルを解析する際にエラーが発生した場合、4D はプロジェクトを読み込みますが、グローバルアクセス保護は無効になります。これにより、開発者はエラー修正のためファイルにアクセスすることができます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。
-`Roles_Errors.json` ファイルが [Logs フォルダー](../Project/architecture.md#logs) に存在するかどうか、起動時に確認することをお勧めします。存在する場合、解析エラーが発生し、アクセスが制限されないことを意味します。 たとえば、次のように書くことができます:
+`Roles_Errors.json` ファイルが [Logs フォルダー](../Project/architecture.md#logs) に存在するかどうか、起動時に確認することをお勧めします。存在する場合、解析エラーが発生し、アクセスが制限されないことを意味します。 たとえば、次のように書くことができます: たとえば、次のように書くことができます: たとえば、次のように書くことができます: たとえば、次のように書くことができます:
```4d title="/Sources/DatabaseMethods/onStartup.4dm"
If (Not(File("/LOGS/"+"Roles_Errors.json").exists))
@@ -224,7 +221,7 @@ End if
## 権限設定の例
-グッドプラクティスは、"none" 権限によってすべてのデータアクセスをデフォルトでロックしておき、`roles.json` ファイルを設定して、許可されたセッションにのみ限定的に一部を開放することです。 たとえば、制限されたアクセスをゲストセッションに対して許可する場合:
+グッドプラクティスは、"none" 権限によってすべてのデータアクセスをデフォルトでロックしておき、`roles.json` ファイルを設定して、許可されたセッションにのみ限定的に一部を開放することです。 たとえば、制限されたアクセスをゲストセッションに対して許可する場合: たとえば、制限されたアクセスをゲストセッションに対して許可する場合: たとえば、制限されたアクセスをゲストセッションに対して許可する場合: たとえば、制限されたアクセスをゲストセッションに対して許可する場合:
```json title="/Project/Sources/roles.json"
@@ -256,9 +253,6 @@ End if
"execute": [
"none"
],
- "describe": [
- "none"
- ],
"promote": [
"none"
]
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md
index 2a52c091400f0b..998c492f199ef1 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md
@@ -7,13 +7,13 @@ title: リモートデータストア
The local 4D application connects to and references the remote datastore through a call to the [`Open datastore`](../commands/open-datastore.md) command.
-リモートマシン上で、4D は [セッション](../WebServer/sessions.md) を開いて、`Open datastore` を呼び出したアプリケーションからのリクエストを処理します。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。
+リモートマシン上で、4D は [セッション](../WebServer/sessions.md) を開いて、`Open datastore` を呼び出したアプリケーションからのリクエストを処理します。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。
## Webセッションの使用
When you work with a remote datastore referenced through calls to the [`Open datastore`](../commands/open-datastore.md) command, the connection with the requesting processes is handled via [web sessions](../WebServer/sessions.md) on the remote machine.
-リモートデータストア上で作成される Webセッションは内部的にセッションID によって識別され、4Dアプリケーション上では `localID` と紐づいています。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。
+リモートデータストア上で作成される Webセッションは内部的にセッションID によって識別され、4Dアプリケーション上では `localID` と紐づいています。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。
`localID` はリモートデータストアに接続しているマシンにおけるローカルな識別IDです:
@@ -39,17 +39,17 @@ When you work with a remote datastore referenced through calls to the [`Open dat
## セッションの終了
-[セッションの有効期限](../WebServer/sessions.md#セッションの有効期限) の段落で説明されているように、アクティビティなしにタイムアウト時間が経過すると、4D は自動的にセッションを終了します。 デフォルトのタイムアウト時間は 60分です。 _Open datastore_ コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。
+[セッションの有効期限](../WebServer/sessions.md#セッションの有効期限) の段落で説明されているように、アクティビティなしにタイムアウト時間が経過すると、4D は自動的にセッションを終了します。 デフォルトのタイムアウト時間は 60分です。 _Open datastore_ コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。 デフォルトのタイムアウト時間は 60分です。 _Open datastore_ コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。 デフォルトのタイムアウト時間は 60分です。 _Open datastore_ コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。 デフォルトのタイムアウト時間は 60分です。 _Open datastore_ コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。
-セッション終了後にリクエストがリモートデータストアに送信された場合、セッションは可能な限り (ライセンスがあり、サーバーが停止していない、など) 再開されます。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。
+セッション終了後にリクエストがリモートデータストアに送信された場合、セッションは可能な限り (ライセンスがあり、サーバーが停止していない、など) 再開されます。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。
## ロッキングとトランザクション
エンティティロッキングやトランザクションに関連した ORDA 機能は、ORDA のクライアント / サーバーモードと同様に、リモートデータストアにおいてもプロセスレベルで管理されます:
-- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。
-- トランザクションは `dataStore.startTransaction( )`、`dataStore.cancelTransaction( )`、`dataStore.validateTransaction( )` のメソッドを使って、リモートデータストアごとに個別に開始・認証・キャンセルすることができます。 これらの操作は他のデータストアには影響しません。
-- 従来の 4Dランゲージコマンド (`START TRANSACTION`, `VALIDATE TRANSACTION`, `CANCEL TRANSACTION`) は `ds` で返されるメインデータストアに対してのみ動作します。
+- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。
+- トランザクションは `dataStore.startTransaction( )`、`dataStore.cancelTransaction( )`、`dataStore.validateTransaction( )` のメソッドを使って、リモートデータストアごとに個別に開始・認証・キャンセルすることができます。 これらの操作は他のデータストアには影響しません。 これらの操作は他のデータストアには影響しません。 これらの操作は他のデータストアには影響しません。 これらの操作は他のデータストアには影響しません。
+- Classic 4D language commands ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) only apply to the main datastore (returned by `ds`).
リモートデータストアのエンティティがあるプロセスのトランザクションで使われている場合、セッションの共有如何に関わらず、他のすべてのプロセスはそのエンティティを更新できません。
- 次の場合にエンティティのロックは解除され、トランザクションはキャンセルされます:
- プロセスが強制終了された
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md
index 9f5c75a489d96d..a32d16919252a9 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md
@@ -3,9 +3,9 @@ id: components
title: コンポーネント
---
-4D のコンポーネントとは、プロジェクトに追加可能な、1つ以上の機能を持つ 4Dコードや 4Dフォームの一式です。 たとえば、[4D SVG](https://github.com/4d/4D-SVG)コンポーネント は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。
+4D のコンポーネントとは、プロジェクトに追加可能な、1つ以上の機能を持つ 4Dコードや 4Dフォームの一式です。 4D のコンポーネントとは、プロジェクトに追加可能な、1つ以上の機能を持つ 4Dコードや 4Dフォームの一式です。 たとえば、[4D SVG](https://github.com/4d/4D-SVG)コンポーネント は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。
-独自の 4Dコンポーネントを [開発](../Extensions/develop-components.md) し、[ビルド](../Desktop/building.md) することもできますし、4Dコミュニティによって共有されているパブリックコンポーネントを [GitHubで見つけて](https://github.com/search?q=4d-component\&type=Repositories) ダウンロードすることもできます。
+独自の 4Dコンポーネントを [開発](../Extensions/develop-components.md) し、[ビルド](../Desktop/building.md) することもできますし、4Dコミュニティによって共有されているパブリックコンポーネントを [GitHubで見つけて](https://github.com/search?q=4d-component\\&type=Repositories) ダウンロードすることもできます。
4D で開発する際、コンポーネントファイルはコンピューター上または Githubリポジトリ上に、透過的に保存することができます。
@@ -14,7 +14,7 @@ title: コンポーネント
Components can be interpreted or [compiled](../Desktop/building.md).
- インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。
-- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。
+- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 この場合、コンパイル済みコンポーネントのみが利用可能です。
### Package folder
@@ -35,7 +35,7 @@ The "Contents" folder architecture is recommended for components if you want to
:::note
-このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります:
+このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります: 他の環境では、コンポーネントの管理は異なります:
- [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。
- 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。
@@ -47,7 +47,7 @@ The "Contents" folder architecture is recommended for components if you want to
4Dプロジェクトにコンポーネントを読み込むには、以下の方法があります:
- [プロジェクトの **Components** フォルダー](architecture.md#components) にコンポーネントファイルをコピーします。
-- または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。
+- or, declare the component in the **dependencies.json** file of your project; this is done automatically for local files when you [**add a dependency using the Dependency manager interface**](#adding-a-github-dependency).
**dependencies.json** ファイルで宣言されているコンポーネントは、異なる場所に保存できます:
@@ -61,7 +61,7 @@ The "Contents" folder architecture is recommended for components if you want to
#### dependencies.json
-**dependencies.json** ファイルは、4Dプロジェクトに必要なすべてのコンポーネントを宣言します。 このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例:
+**dependencies.json** ファイルは、4Dプロジェクトに必要なすべてのコンポーネントを宣言します。 このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例: このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例:
```
/MyProjectRoot/Project/Sources/dependencies.json
@@ -95,14 +95,16 @@ The "Contents" folder architecture is recommended for components if you want to
```mermaid
flowchart TB
- id1("1\nプロジェクトの Components フォルダーにあるコンポーネント")~~~
- id2("2\ndependencies.json にリストされたコンポーネント")~~~
- id2 -- environment4d.json にパスがある --> id4("environment4d.json に\n宣言されたパスの\nコンポーネントをロード")
+ id1("1This の値は実行時に代入により設定することはできません。また、呼び出されるたびに違う値となりえます。
+`This` の値は、呼ばれ方によって決まります。 この値は実行時に代入により設定することはできません。また、呼び出されるたびに違う値となりえます。
-This command can be used in different contexts, described below. Within these contexts, you will access object/collection element properties or entity attributes through **This.<*propertyPath*\>**. For example, *This.name* or *This.employer.lastName* are valid pathes to object, element or entity properties.
+このコマンドは以下で説明するように、異なるコンテキストで使用することができます。 これらのコンテキストの中においては、**This.<*propertyPath*\>** を通してオブジェクト/コレクションの要素プロパティやエンティティの属性にアクセスすることができます。 例えば、*This.name* や*This.employer.lastName* はオブジェクト、要素やエンティティプロパティへの有効なパスとなります。
-In any other context, the command returns **Null**.
+これら以外のコンテキストにおいては、コマンドは**Null** を返します。
#### クラス関数
@@ -45,9 +45,9 @@ $o:=cs.ob.new()
$val:=$o.a //42
```
-> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。 See [this example](super.md#example-1).
+> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](super.md#例題-1) を参照ください。
-基本的に、`This` はメソッドの呼び出し元のオブジェクトを指します。
+いずれの場合においても、`This` はメソッドの呼び出し元のオブジェクトを指します。
```4d
//Class: ob
@@ -66,24 +66,24 @@ $val:=$o.f() //8
```
-この例では、変数 $o に代入されたオブジェクトは *f* プロパティを持たないため、これをクラスより継承します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。
+この例では、変数 $o に代入されたオブジェクトは *f* プロパティを持たないため、これをクラスより継承します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。
#### フォーミュラオブジェクト
-In the context of the execution of a formula object created by the [Formula](formula.md) or [Formula from string](formula-from-string.md) commands, `This` returns a reference to the object currently processed by the formula.
+[Formula](formula.md) あるいは [Formula from string](formula-from-string.md) コマンドで作成されたフォーミュラオブジェクトの実行コンテキストにおいては、`This` はフォーミュラによって現在処理されているオブジェクトへの参照を返します。
-For example, you want to use a project method as a formula encapsulated in an object:
+例えば、プロジェクトをオブジェクトのカプセル化されたフォーミュラとして使用したい場合を考えます:
```4d
var $person : Object := New object
$person.firstName:="John"
$person.lastName:="Smith"
$person.greeting:=Formula(Greeting)
- $g:=$person.greeting("hello") // returns "hello John Smith"
- $g:=$person.greeting("hi") // returns "hi John Smith"
+ $g:=$person.greeting("hello") // "hello John Smith" を返す
+ $g:=$person.greeting("hi") // "hi John Smith" を返す
```
-With the *Greeting* project method:
+*Greeting* プロジェクトメソッドの中身は以下のようになっています:
```4d
#DECLARE($greeting : Text) : Text
@@ -92,17 +92,17 @@ With the *Greeting* project method:
#### リストボックス
-In the context of a list box associated to a collection or an entity selection, during the [`On Display Detail`](../Events/onDisplayDetail.md) or the [`On Data Change`](../Events/onDataChange.md) events, `This` returns a reference to the collection element or entity accessed by the list box to display the current row.
+コレクションまたはエンティティセレクションに割り当てられたリストボックスのコンテキストにおいては、[`On Display Detail`](../Events/onDisplayDetail.md) あるいは [`On Data Change`](../Events/onDataChange.md) イベントの最中において、は現在の行を表示するためにリストボックス割り当てられたコレクション要素またはエンティティへの参照を返します。
-:::note
+:::注意
-If you use a collection of scalar values in a list box, 4D creates an object for each element with a single **value** property. Thus, the element value is returned by the **This.value** non-assignable expression.
+スカラー値のコレクションをリストボックスに対して使用した場合、4D はそれぞれの要素に対して、単一のプロパティ**value** を持つオブジェクトを作成します。 Thus, the element value is returned by the **This.value** non-assignable expression. そのため、要素の値は**This.value** という代入不可の式によって返されます。
:::
#### 例題 1
-A collection of objects, each with this structure:
+以下のような構造を持つオブジェクトのコレクションがある場合を考えます:
```json
{
@@ -127,14 +127,14 @@ A collection of objects, each with this structure:
```
-In the list box, each column refers to one of the properties of the object, either directly (This.name), indirectly (This.employees.length), or through an expression (*getPicture*) in which can be used directly. The list box looks like:
+リストボックス内では、各カラムはオブジェクトのプロパティいずれか一つを、直接的(This.name) に、あるいは間接的(This.employees.length) に、あるいは直接使用できる式(*getPicture*) を通して参照しています。 このリストボックスは、以下のようになります: このリストボックスは、以下のようになります:
-The *GetPicture* project method is automatically executed during the **On display detail** event:
+*GetPicture* プロジェクトメソッドは、**On display detail** イベント中に自動的に実行されます:
```4d
- //GetPicture Method
+ //GetPicture メソッド
#DECLARE -> $genderPict : Picture
If(This.isFemale)
$genderPict:=Form.genericFemaleImage
@@ -143,34 +143,34 @@ The *GetPicture* project method is automatically executed during the **On displa
End if
```
-Once the form is executed, you can see the result:
+フォームを実行すると、以下のような結果が表示されます:
#### 例題 2
-You want to display entities from the following structure in a list box:
+以下のようなストラクチャーからのエンティティをリストボックスに表示したい場合を考えます:
-You build a list box of the "Collection or entity selection" type with the following definition:
+その場合、以下のような定義を持つ"コレクションまたはエンティティセレクション"型のリストボックスを作成します:
-注:
+注意:
-- *This.ID*, *This.Title* and *This.Date* directly refers to the corresponding attributes in the ds.Event dataclass.
-- *This.meetings* is a related attribute (based upon the One To Many relation name) that returns an entity selection of the ds.Meeting dataclass.
-- **Form.eventList** is the entity selection that is attached to the list box. The initialization code can be put in the on load form event:
+- *This.ID*、*This.Title* および *This.Date* は、ds.Event データクラス内の対応する属性を直接参照します。
+- *This.meetings* は(1対N リレーション名に基づいた)リレーション属性であり、ds.Meeting データクラスのエンティティセレクションを返します。
+- **Form.eventList** はリストボックスに割り当てられているエンティティセレクションです。 初期化コードは、On Load フォームイベント内で以下のように書くことができます: 初期化コードは、On Load フォームイベント内で以下のように書くことができます:
```4d
Case of
:(Form event code=On Load)
- Form.eventList:=ds.Event.all() //returns an entity selection with all entities
+ Form.eventList:=ds.Event.all() //全てのエンティティを格納したエンティティセレクションを返す
End case
```
-Once the form is executed, the list box is automatically filled with the entity selection:
+フォームが実行されると、リストボックスにはエンティティセレクションが入った状態で表示されます:
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/use-entity-selection.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/use-entity-selection.md
index 2dc0fd7758d0f8..1b60f7c8013bcd 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/use-entity-selection.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/use-entity-selection.md
@@ -16,7 +16,7 @@ displayed_sidebar: docs
#### 説明
-The `USE ENTITY SELECTION` command updates the current selection of the table matching the dataclass of the *entitySelection* parameter, according to the content of the entity selection.
+`USE ENTITY SELECTION` コマンドは、*entitySelection* 引数のデータクラスに合致するテーブルのカレントセレクションを、渡したエンティティセレクションの内容で更新します。
[リモートデータストア](../ORDA/remoteDatastores.md) の場合は、このコマンドは使用できません。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server-list.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server-list.md
index 26a265e12f6bf5..342f4650eda288 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server-list.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server-list.md
@@ -8,9 +8,9 @@ displayed_sidebar: docs
-| 引数 | 型 | | 説明 |
-| --- | ---------- | - | ---------------------------------------------- |
-| 戻り値 | Collection | ← | Collection of the available Web Server objects |
+| 引数 | 型 | | 説明 |
+| --- | ---------- | - | -------------------------- |
+| 戻り値 | Collection | ← | 利用可能なWeb サーバーオブジェクトのコレクション |
@@ -33,9 +33,9 @@ displayed_sidebar: docs
サーバーが実際に実行中か否かに関わらず、`WEB Server list` コマンドは利用可能な Webサーバーをすべて返します。
-> デフォルトの Webサーバーオブジェクトは、4D 起動時に自動的にロードされます。 On the other hand, each component Web server that you want to use must be instantiated using the [`WEB Server`](web-server.md) command.
+> デフォルトの Webサーバーオブジェクトは、4D 起動時に自動的にロードされます。 一方で、使用したいコンポーネントのWeb サーバーは、[`WEB Server`](web-server.md) コマンドによってそれぞれインスタンス化されている必要があります。
-You can use the [.name](../API/WebServerClass.md#name) property of the Web server object to identify the project or component to which each Web server object in the list is attached.
+Webサーバオブジェクトの [.name](../API/WebServerClass.md#name) プロパティを使用することで、リスト内の各 Webサーバーオブジェクトが関連づけられているデータベースまたはコンポーネントを識別することができます。
#### 例題
@@ -47,7 +47,7 @@ You can use the [.name](../API/WebServerClass.md#name) property of the Web serve
$wSList:=WEB Server list
$vRun:=$wSList.countValues(True;"isRunning")
- ALERT(String($vRun)+" web server(s) running on "+String($wSList.length)+" available.")
+ ALERT(String($wSList.length)+" 個のリストの中で、"+String($vRun)+" 個の Web サーバーが実行中です。")
```
#### 参照
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server.md
index 7cbd5b845487e6..01bb277fab8cf4 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/web-server.md
@@ -15,7 +15,7 @@ displayed_sidebar: docs
-*This command is not thread-safe, it cannot be used in preemptive code.*
+*このコマンドはスレッドセーフではないので、プリエンプティブなコードでは使用できません。*
| タイプ | 説明 |
|---|---|
| String | ドット記法を使用して表現された attributePath (例: "name" または "user.address.zipCode") |
| String の Collection | コレクションの各要素が attributePath の階層を表します (例: ["name"] または ["user","address","zipCode"])。 コレクションを使用することで、ドット記法に準じていない名前の属性に対してもクエリすることができます (例: ["4Dv17.1","en/fr"])。 |
| タイプ | 説明 |
|---|---|
| String | ドット記法を使用して表現された attributePath (例: "name" または "user.address.zipCode") |
| String の Collection | コレクションの各要素が attributePath の階層を表します (例: ["name"] または ["user","address","zipCode"])。 コレクションを使用することで、ドット記法に準じていない名前の属性に対してもクエリすることができます (例: ["4Dv17.1","en/fr"])。 |
ds コマンドによって返されます。
+開かれている 4Dデータベース (シングルユーザーまたはクライアント/サーバー) に対応するデータストアオブジェクト。 メインデータストアは ds コマンドによって返されます。 メインデータストアは ds コマンドによって返されます。 メインデータストアは ds コマンドによって返されます。 メインデータストアは ds コマンドによって返されます。
## メソッド
-データストア、データクラス、エンティティセレクション、エンティティなどの ORDA オブジェクトは、オブジェクトのクラスを定義します。 これらのクラスには、オブジェクトを直接操作するための専用のメソッドが提供されています。 これらのメソッドはメンバー関数とも呼ばれます。 このメソッドを使用するには、オブジェクトのインスタンスに対して呼び出します。
+データストア、データクラス、エンティティセレクション、エンティティなどの ORDA オブジェクトは、オブジェクトのクラスを定義します。 これらのクラスには、オブジェクトを直接操作するための専用のメソッドが提供されています。 これらのメソッドはメンバー関数とも呼ばれます。 このメソッドを使用するには、オブジェクトのインスタンスに対して呼び出します。 これらのクラスには、オブジェクトを直接操作するための専用のメソッドが提供されています。 これらのメソッドはメンバー関数とも呼ばれます。 このメソッドを使用するには、オブジェクトのインスタンスに対して呼び出します。
-たとえば、`query()` メソッドはデータクラスのメンバー関数です。 `$myClass` 変数にデータクラスオブジェクトを格納している場合、次のように書くことができます:
+たとえば、`query()` メソッドはデータクラスのメンバー関数です。 たとえば、`query()` メソッドはデータクラスのメンバー関数です。 たとえば、`query()` メソッドはデータクラスのメンバー関数です。 `$myClass` 変数にデータクラスオブジェクトを格納している場合、次のように書くことができます: たとえば、`query()` メソッドはデータクラスのメンバー関数です。 たとえば、`query()` メソッドはデータクラスのメンバー関数です。 `$myClass` 変数にデータクラスオブジェクトを格納している場合、次のように書くことができます:
```code4d
$myClass.query("name = smith")
@@ -127,7 +127,7 @@ $myClass.query("name = smith")
## ミックスデータ型
-このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 :
+このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : : : :
- 数値
- テキスト
@@ -156,11 +156,11 @@ $myClass.query("name = smith")
[属性](#属性) を参照してください。
-> 属性とプロパティは似た概念です。 "属性" はデータを保存するデータクラスプロパティを指定するのに使われるのに対し、"プロパティ"はより一般的な概念でオブジェクト内で保存されるデータを定義します。
+> 属性とプロパティは似た概念です。 *属性* と *プロパティ* は似た概念です。 "属性" はデータを保存するデータクラスプロパティを指定するのに使われるのに対し、"プロパティ"はより一般的な概念でオブジェクト内で保存されるデータを定義します。 "属性" はデータを保存するデータクラスプロパティを指定するのに使われるのに対し、"プロパティ"はより一般的な概念でオブジェクト内で保存されるデータを定義します。
## プロパティパス
-プロパティパスとは、あるオブジェクトのプロパティへのパスです。 プロパティが複数の階層にネストされている場合、各階層はドット (".") によって区切られます。
+属性パスとは、あるデータクラスあるいはエンティティ内の属性へのパスです。 [プロパティパス](#プロパティパス) も参照ください。 プロパティが複数の階層にネストされている場合、各階層はドット (".") によって区切られます。
## 通常クラス
@@ -189,23 +189,23 @@ ORDA オブジェクトとは関わりのないユーザークラス。
## リモートデータストア
-4D または (HTTP経由で利用可能な) 4D Server 上で開かれている、REST リソースとして公開された 4Dデータベース。 このデータベースは他のマシンにおいてデータストアとしてローカルに参照することができ、その際には割り当てられた locaID で識別されます。 リモートデータストアは ORDA の概念 (データストア、データクラス、エンティティセレクション等) を使って利用できます。 利用にあたってはライセンスが消費されます。
+4D または (HTTP経由で利用可能な) 4D Server 上で開かれている、REST リソースとして公開された 4Dデータベース。 このデータベースは他のマシンにおいてデータストアとしてローカルに参照することができ、その際には割り当てられた locaID で識別されます。 リモートデータストアは ORDA の概念 (データストア、データクラス、エンティティセレクション等) を使って利用できます。 利用にあたってはライセンスが消費されます。 このデータベースは他のマシンにおいてデータストアとしてローカルに参照することができ、その際には割り当てられた locaID で識別されます。 リモートデータストアは ORDA の概念 (データストア、データクラス、エンティティセレクション等) を使って利用できます。 利用にあたってはライセンスが消費されます。
## リソース
-[権限](#権限) における [アクション](#アクション) の許可・拒否の対象となる ORDA 要素。 利用可能なリソースは、データストア、データクラス、データクラス属性、ORDAデータモデル関数のいずれかです。
+[権限](#権限) における [アクション](#アクション) の許可・拒否の対象となる ORDA 要素。 利用可能なリソースは、データストア、データクラス、データクラス属性、ORDAデータモデル関数のいずれかです。 利用可能なリソースは、データストア、データクラス、データクラス属性、ORDAデータモデル関数のいずれかです。
## ロール
-ロールとは、管理者が使用することを目的とした、公開された [権限](#権限) のことです。 ロールは 1つ以上の権限を持つことができます。
+ロールとは、管理者が使用することを目的とした、公開された [権限](#権限) のことです。 ロールは 1つ以上の権限を持つことができます。 ロールは 1つ以上の権限を持つことができます。 ロールは 1つ以上の権限を持つことができます。
## セッション
-4Dアプリケーションがリモートデータストアに接続すると、4D Server (HTTP) 上では セッション が作成されます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。
+4Dアプリケーションがリモートデータストアに接続すると、4D Server (HTTP) 上では セッション が作成されます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。 セッションcookie が生成され、ローカルデータストアID と紐づけられます。
-新規セッションが開始されるごとに、ライセンスが消費されます。 セッションが閉じられると、ライセンスは解放されます。
+新規セッションが開始されるごとに、ライセンスが消費されます。 セッションが閉じられると、ライセンスは解放されます。 セッションが閉じられると、ライセンスは解放されます。 セッションが閉じられると、ライセンスは解放されます。 セッションが閉じられると、ライセンスは解放されます。
-アクティビティのないセッションはタイムアウト後に自動的に終了します。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。
+アクティビティのないセッションはタイムアウト後に自動的に終了します。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。 デフォルトのタイムアウトは 48時間で、任意に設定することができます (最少時間は 60分)。
## シャロウコピー
@@ -217,4 +217,4 @@ ORDA オブジェクトとは関わりのないユーザークラス。
## ストレージ属性
-ストレージ属性 (スカラー属性と呼ばれることも) は、データストアクラスの属性の中で最も基本的なタイプであり、リレーショナルデータベースのフィールドに最も直接的に対応するものです。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。
+ストレージ属性 (スカラー属性と呼ばれることも) は、データストアクラスの属性の中で最も基本的なタイプであり、リレーショナルデータベースのフィールドに最も直接的に対応するものです。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。 ストレージ属性は、データクラスのエンティティ毎に 1つの値を持ちます。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md
index 71dd4ea13461a6..4ccf6add740124 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md
@@ -3,13 +3,13 @@ id: privileges
title: 権限
---
-データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 ORDA のセキュリティアーキテクチャーはデータストアの中心に実装されており、プロジェクト内のさまざまなリソース (データストア、データクラス、関数など) に対して、すべての Web または REST ユーザーセッションに特定の権限を定義することができます。
+データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 ORDA のセキュリティアーキテクチャーはデータストアの中心に実装されており、プロジェクト内のさまざまなリソース (データストア、データクラス、関数など) に対して、すべての Web または REST ユーザーセッションに特定の権限を定義することができます。
## 概要
ORDA のセキュリティアーキテクチャーは、権限、許諾アクション (read、create など)、およびリソースの概念に基づいています。
-Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。
+Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。
セッション内で送信されるユーザーリクエストは、プロジェクトの `roles.json` ファイルで定義された権限に対して評価されます。
@@ -36,12 +36,12 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ
あるレベルにおいて定義されたパーミッションは基本的に下位レベルに継承されますが、パーミッションは複数のレベルで設定することもできます:
- データストアレベルで定義されたパーミッションは、自動的にすべてのデータクラスに割り当てられます。
-- データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。
-- データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。
+- データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。
+- データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。 データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。 データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。 たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。
:::info
-パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。 特定の条件に基づいて読み取りデータをフィルタリングしたい場合は、[制限付エンティティセレクション](entities.md#制限付エンティティセレクション) の利用がより適切かもしれません。
+パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。 パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。 特定の条件に基づいて読み取りデータをフィルタリングしたい場合は、[制限付エンティティセレクション](entities.md#制限付エンティティセレクション) の利用がより適切かもしれません。
:::
@@ -49,15 +49,14 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ
利用可能なアクションは対象となるリソースによります。
-| アクション | データストア | データクラス | 属性 | データモデル関数またはシングルトン関数 |
-| ------------ | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| **create** | 任意のデータクラスにおいてエンティティを作成 | 当該データクラスにおいてエンティティを作成 | 当該属性に許可されたデフォルト値とは異なる値を持つエンティティを作成 (エイリアス属性の場合は無視されます) | n/a |
-| **read** | 任意のデータクラスにおいて属性を読み取り | 当該データクラスにおいて属性を読み取り | 当該属性を読み取り | n/a |
-| **update** | 任意のデータクラスにおいて属性を更新 | 当該データクラスにおいて属性を更新 | 当該属性を更新 (エイリアス属性の場合は無視されます) | n/a |
-| **drop** | 任意のデータクラスにおいてデータを削除 | 当該データクラスにおいてデータを削除 | 当該属性の null でない値を削除 (エイリアス属性と計算属性を除く) | n/a |
-| **execute** | プロジェクトの任意の関数を実行 (データストア、データクラス、エンティティセレクション、エンティティ) | データクラスの任意の関数を実行。 データクラス関数、エンティティ関数、エンティティセレクション関数は、データクラスの関数として扱われます。 | n/a | 当該関数を実行 |
-| **describe** | /rest/$catalog API ですべてのデータクラスが利用可能 | /rest/$catalog API で当該データクラスが利用可能 | /rest/$catalog API で当該属性が利用可能 | /rest/$catalog API で当該データクラス関数が利用可能 (シングルトン関数は利用できません) |
-| **promote** | n/a | n/a | n/a | 関数の実行に指定の権限を関連付けます。 権限は一時的にセッションに追加され、関数の実行終了とともに削除されます。 セキュリティ上、セッション全体ではなく、当該関数を実行するプロセスのみに権限が追加されます。 |
+| アクション | データストア | データクラス | 属性 | データモデル関数またはシングルトン関数 |
+| ----------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **create** | 任意のデータクラスにおいてエンティティを作成 | 当該データクラスにおいてエンティティを作成 | 当該属性に許可されたデフォルト値とは異なる値を持つエンティティを作成 (エイリアス属性の場合は無視されます) | n/a |
+| **read** | 任意のデータクラスにおいて属性を読み取り | 当該データクラスにおいて属性を読み取り | 当該属性を読み取り | n/a |
+| **update** | 任意のデータクラスにおいて属性を更新 | 当該データクラスにおいて属性を更新 | 当該属性を更新 (エイリアス属性の場合は無視されます) | n/a |
+| **drop** | 任意のデータクラスにおいてデータを削除 | 当該データクラスにおいてデータを削除 | 当該属性の null でない値を削除 (エイリアス属性と計算属性を除く) | n/a |
+| **execute** | プロジェクトの任意の関数を実行 (データストア、データクラス、エンティティセレクション、エンティティ) | データクラスの任意の関数を実行。 データクラスの任意の関数を実行。 データクラスの任意の関数を実行。 データクラスの任意の関数を実行。 データクラス関数、エンティティ関数、エンティティセレクション関数は、データクラスの関数として扱われます。 | n/a | 当該関数を実行 |
+| **promote** | n/a | n/a | n/a | 関数の実行に指定の権限を関連付けます。 権限は一時的にセッションに追加され、関数の実行終了とともに削除されます。 関数の実行に指定の権限を関連付けます。 権限は一時的にセッションに追加され、関数の実行終了とともに削除されます。 セキュリティ上、セッション全体ではなく、当該関数を実行するプロセスのみに権限が追加されます。 |
**注:**
@@ -67,18 +66,15 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ
- デフォルト値: 現在の実装では、*Null* のみデフォルト値として利用可能です。
- REST の [強制ログインモード](../REST/authUsers.md/#強制ログインモード) では、[`authentify()`関数](../REST/authUsers.md#function-authentify) は、権限の設定に関係なく常にゲストユーザーによって実行可能です。
-許諾の設定は一貫している必要があります。とくに:
-
-- **update** および **drop** アクションには **read** が必要です (**create** には不要です)
-- データモデル関数の場合、**promote** アクションには **describe** が必要です。
+Setting permissions requires to be consistent, in particular **update** and **drop** permissions also need **read** permission (but **create** does not need it).
## 権限とロール
-**権限** とは、**リソース** に対して **アクション** を実行する技術的な能力であり、**ロール** は、管理者が使用するために公開された権限のことです。 基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。 たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。
+**権限** とは、**リソース** に対して **アクション** を実行する技術的な能力であり、**ロール** は、管理者が使用するために公開された権限のことです。 基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。 たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。 基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。 たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。
権限は、複数の "リソース+アクション" の組み合わせと関連付けることができます。 また、一つのアクションに複数の権限を関連付けることができます。 権限は、他の権限を含むことができます。
-- 権限やロールの **作成** は `roles.json` ファイル内にておこないます (後述参照)。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。
+- 権限やロールの **作成** は `roles.json` ファイル内にておこないます (後述参照)。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。
- 各ユーザーセッションに権限やロールを **許可** するには、`Session` クラスの [`.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数を使用します。
@@ -140,7 +136,6 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T
"create": ["none"],
"update": ["none"],
"drop": ["none"],
- "describe": ["none"],
"execute": ["none"],
"promote": ["none"]
}
@@ -153,17 +148,20 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T
```
-最高レベルのセキュリティのため、データストア ("ds") のすべての許諾アクションに "none" の権限名が割り当てられています。したがって、デフォルトでは `ds` オブジェクト全体へのデータアクセスが無効になっています。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。
+最高レベルのセキュリティのため、データストア ("ds") のすべての許諾アクションに "none" の権限名が割り当てられています。したがって、デフォルトでは `ds` オブジェクト全体へのデータアクセスが無効になっています。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。 この "none" 権限はセキュリティのため、使用も変更もしないことが推奨されています。Web や RESTリクエストから利用可能にしたい各リソースには、それ専用の権限を新たに追加することが推奨されています ([以下の例を参照](#権限設定の例))。
:::caution
-`roles.json` ファイルに特定のパラメーターが定義されていない場合、アクセスは制限されません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。
+`roles.json` ファイルに特定のパラメーターが定義されていない場合、アクセスは制限されません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。 これにより、アクセスを気にすることなくアプリケーションを開発することができますが、本番環境では推奨されていません。
:::
:::note 互換性
-以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 4D 20 R6 以降、`roles.json`ファイルを含まない、または `"forceLogin": true` の設定が含まれていない既存のプロジェクトを開く場合、[設定ダイアログボックスの **Web機能** ページ](../settings/web.md#アクセス権) で **ds.authentify() 関数を通しての REST認証を有効化** ボタンが利用可能になります。 このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 4D 20 R6 以降、`roles.json`ファイルを含まない、または `"forceLogin": true` の設定が含まれていない既存のプロジェクトを開く場合、[設定ダイアログボックスの **Web機能** ページ](../settings/web.md#アクセス権) で **ds.authentify() 関数を通しての REST認証を有効化** ボタンが利用可能になります。 このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+::: このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+::: このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
+::: このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。
:::
:::note Qodly Studio
@@ -176,41 +174,40 @@ Qodly Studio for 4D では、権限パネルの [**強制ログイン**オプシ
`roles.json` ファイルの構文は次のとおりです:
-| プロパティ名 | | | 型 | 必須 | 説明 |
-| ----------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------ |
-| privileges | | | `privilege` オブジェクトの Collection | ○ | 定義された権限のリスト |
-| | \[].privilege | | Text | | アクセス権の名称 |
-| | \[].includes | | String の Collection | | 内包する権限名のリスト |
-| roles | | | `role` オブジェクトの Collection | | 定義されたロールのリスト |
-| | \[].role | | Text | | ロール名 |
-| | \[].privileges | | String の Collection | | 内包する権限名のリスト |
-| permissions | | | Object | ○ | 設定されたパーミッションのリスト |
-| | allowed | | `permission` オブジェクトの Collection | | 許可されたパーミッションのリスト |
-| | | \[].applyTo | Text | ○ | 対象の [リソース](#リソース) 名 |
-| | | \[].type | Text | ○ | [リソース](#リソース) タイプ: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" |
-| | | \[].read | String の Collection | | 権限名のリスト |
-| | | \[].create | String の Collection | | 権限名のリスト |
-| | | \[].update | String の Collection | | 権限名のリスト |
-| | | \[].drop | String の Collection | | 権限名のリスト |
-| | | \[].describe | String の Collection | | 権限名のリスト |
-| | | \[].execute | String の Collection | | 権限名のリスト |
-| | | \[].promote | String の Collection | | 権限名のリスト |
-| forceLogin | | | Boolean | | ["forceLogin" モード](../REST/authUsers.md#force-login-mode) を有効にする場合は true |
+| プロパティ名 | | | 型 | 必須 | 説明 |
+| ----------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------ |
+| privileges | | | `privilege` オブジェクトの Collection | ○ | 定義された権限のリスト |
+| | \[].privilege | | Text | | アクセス権の名称 |
+| | \[].includes | | String の Collection | | 内包する権限名のリスト |
+| roles | | | `role` オブジェクトの Collection | | 定義されたロールのリスト |
+| | \[].role | | Text | | ロール名 |
+| | \[].privileges | | String の Collection | | 内包する権限名のリスト |
+| permissions | | | Object | ○ | 設定されたパーミッションのリスト |
+| | allowed | | `permission` オブジェクトの Collection | | 許可されたパーミッションのリスト |
+| | | \[].applyTo | Text | ○ | 対象の [リソース](#リソース) 名 |
+| | | \[].type | Text | ○ | [リソース](#リソース) タイプ: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" |
+| | | \[].read | String の Collection | | 権限名のリスト |
+| | | \[].create | String の Collection | | 権限名のリスト |
+| | | \[].update | String の Collection | | 権限名のリスト |
+| | | \[].drop | String の Collection | | 権限名のリスト |
+| | | \[].execute | String の Collection | | 権限名のリスト |
+| | | \[].promote | String の Collection | | 権限名のリスト |
+| forceLogin | | | Boolean | | ["forceLogin" モード](../REST/authUsers.md#force-login-mode) を有効にする場合は true |
:::caution 注記
-- "WebAdmin" 権限名は、アプリケーションによって予約されています。 この名前をカスタムの権限名に使用することは推奨されません。
+- "WebAdmin" 権限名は、アプリケーションによって予約されています。 この名前をカスタムの権限名に使用することは推奨されません。 この名前をカスタムの権限名に使用することは推奨されません。 この名前をカスタムの権限名に使用することは推奨されません。 この名前をカスタムの権限名に使用することは推奨されません。
- `privileges` および `roles` の名称においては文字の大小が区別されます。
:::
### `Roles_Errors.json` ファイル
-`roles.json` ファイルは、4D 起動時に解析されます。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。
+`roles.json` ファイルは、4D 起動時に解析されます。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。
-`roles.json` ファイルを解析する際にエラーが発生した場合、4D はプロジェクトを読み込みますが、グローバルアクセス保護は無効になります。これにより、開発者はエラー修正のためファイルにアクセスすることができます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。
+`roles.json` ファイルを解析する際にエラーが発生した場合、4D はプロジェクトを読み込みますが、グローバルアクセス保護は無効になります。これにより、開発者はエラー修正のためファイルにアクセスすることができます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。 このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。
-`Roles_Errors.json` ファイルが [Logs フォルダー](../Project/architecture.md#logs) に存在するかどうか、起動時に確認することをお勧めします。存在する場合、解析エラーが発生し、アクセスが制限されないことを意味します。 たとえば、次のように書くことができます:
+`Roles_Errors.json` ファイルが [Logs フォルダー](../Project/architecture.md#logs) に存在するかどうか、起動時に確認することをお勧めします。存在する場合、解析エラーが発生し、アクセスが制限されないことを意味します。 たとえば、次のように書くことができます: たとえば、次のように書くことができます: たとえば、次のように書くことができます: たとえば、次のように書くことができます:
```4d title="/Sources/DatabaseMethods/onStartup.4dm"
If (Not(File("/LOGS/"+"Roles_Errors.json").exists))
@@ -224,7 +221,7 @@ End if
## 権限設定の例
-グッドプラクティスは、"none" 権限によってすべてのデータアクセスをデフォルトでロックしておき、`roles.json` ファイルを設定して、許可されたセッションにのみ限定的に一部を開放することです。 たとえば、制限されたアクセスをゲストセッションに対して許可する場合:
+グッドプラクティスは、"none" 権限によってすべてのデータアクセスをデフォルトでロックしておき、`roles.json` ファイルを設定して、許可されたセッションにのみ限定的に一部を開放することです。 たとえば、制限されたアクセスをゲストセッションに対して許可する場合: たとえば、制限されたアクセスをゲストセッションに対して許可する場合: たとえば、制限されたアクセスをゲストセッションに対して許可する場合: たとえば、制限されたアクセスをゲストセッションに対して許可する場合:
```json title="/Project/Sources/roles.json"
@@ -256,9 +253,6 @@ End if
"execute": [
"none"
],
- "describe": [
- "none"
- ],
"promote": [
"none"
]
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md
index 2d6ffe74d2d7a3..bb34621b264531 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md
@@ -7,13 +7,13 @@ title: リモートデータストア
The local 4D application connects to and references the remote datastore through a call to the [`Open datastore`](../commands/open-datastore.md) command.
-リモートマシン上で、4D は [セッション](../WebServer/sessions.md) を開いて、`Open datastore` を呼び出したアプリケーションからのリクエストを処理します。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。
+リモートマシン上で、4D は [セッション](../WebServer/sessions.md) を開いて、`Open datastore` を呼び出したアプリケーションからのリクエストを処理します。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。 リクエストは内部で [REST API](../REST/gettingStarted.md) を使用し、これには [利用可能なライセンス](../REST/authUsers.md) が必要な場合があります。
## Webセッションの使用
When you work with a remote datastore referenced through calls to the [`Open datastore`](../commands/open-datastore.md) command, the connection with the requesting processes is handled via [web sessions](../WebServer/sessions.md) on the remote machine.
-リモートデータストア上で作成される Webセッションは内部的にセッションID によって識別され、4Dアプリケーション上では `localID` と紐づいています。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。
+リモートデータストア上で作成される Webセッションは内部的にセッションID によって識別され、4Dアプリケーション上では `localID` と紐づいています。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。 データ、エンティティセレクション、エンティティへのアクセスはこのセッションによって自動的に管理されます。
`localID` はリモートデータストアに接続しているマシンにおけるローカルな識別IDです:
@@ -39,17 +39,17 @@ When you work with a remote datastore referenced through calls to the [`Open dat
## セッションの終了
-[セッションの有効期限](../WebServer/sessions.md#セッションの有効期限) の段落で説明されているように、アクティビティなしにタイムアウト時間が経過すると、4D は自動的にセッションを終了します。 デフォルトのタイムアウト時間は 60分です。 *Open datastore* コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。
+[セッションの有効期限](../WebServer/sessions.md#セッションの有効期限) の段落で説明されているように、アクティビティなしにタイムアウト時間が経過すると、4D は自動的にセッションを終了します。 デフォルトのタイムアウト時間は 60分です。 *Open datastore* コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。 デフォルトのタイムアウト時間は 60分です。 *Open datastore* コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。 デフォルトのタイムアウト時間は 60分です。 *Open datastore* コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。 デフォルトのタイムアウト時間は 60分です。 *Open datastore* コマンドの `connectionInfo` パラメーターを指定して、タイムアウト時間を変更することができます。
-セッション終了後にリクエストがリモートデータストアに送信された場合、セッションは可能な限り (ライセンスがあり、サーバーが停止していない、など) 再開されます。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。
+セッション終了後にリクエストがリモートデータストアに送信された場合、セッションは可能な限り (ライセンスがあり、サーバーが停止していない、など) 再開されます。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。 ただしセッションが再開しても、ロックやトランザクションに関わるコンテキストは失われていることに留意が必要です (後述参照)。
## ロッキングとトランザクション
エンティティロッキングやトランザクションに関連した ORDA 機能は、ORDA のクライアント / サーバーモードと同様に、リモートデータストアにおいてもプロセスレベルで管理されます:
-- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。
-- トランザクションは `dataStore.startTransaction( )`、`dataStore.cancelTransaction( )`、`dataStore.validateTransaction( )` のメソッドを使って、リモートデータストアごとに個別に開始・認証・キャンセルすることができます。 これらの操作は他のデータストアには影響しません。
-- 従来の 4Dランゲージコマンド (`START TRANSACTION`, `VALIDATE TRANSACTION`, `CANCEL TRANSACTION`) は `ds` で返されるメインデータストアに対してのみ動作します。
+- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。
+- トランザクションは `dataStore.startTransaction( )`、`dataStore.cancelTransaction( )`、`dataStore.validateTransaction( )` のメソッドを使って、リモートデータストアごとに個別に開始・認証・キャンセルすることができます。 これらの操作は他のデータストアには影響しません。 これらの操作は他のデータストアには影響しません。 これらの操作は他のデータストアには影響しません。 これらの操作は他のデータストアには影響しません。
+- Classic 4D language commands ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) only apply to the main datastore (returned by `ds`).
リモートデータストアのエンティティがあるプロセスのトランザクションで使われている場合、セッションの共有如何に関わらず、他のすべてのプロセスはそのエンティティを更新できません。
- 次の場合にエンティティのロックは解除され、トランザクションはキャンセルされます:
- プロセスが強制終了された
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md
index 3f60a661a528f9..11209551450713 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md
@@ -3,9 +3,9 @@ id: components
title: コンポーネント
---
-4D のコンポーネントとは、プロジェクトに追加可能な、1つ以上の機能を持つ 4Dコードや 4Dフォームの一式です。 たとえば、[4D SVG](https://github.com/4d/4D-SVG)コンポーネント は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。
+4D のコンポーネントとは、プロジェクトに追加可能な、1つ以上の機能を持つ 4Dコードや 4Dフォームの一式です。 4D のコンポーネントとは、プロジェクトに追加可能な、1つ以上の機能を持つ 4Dコードや 4Dフォームの一式です。 たとえば、[4D SVG](https://github.com/4d/4D-SVG)コンポーネント は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。
-独自の 4Dコンポーネントを [開発](../Extensions/develop-components.md) し、[ビルド](../Desktop/building.md) することもできますし、4Dコミュニティによって共有されているパブリックコンポーネントを [GitHubで見つけて](https://github.com/search?q=4d-component\&type=Repositories) ダウンロードすることもできます。
+独自の 4Dコンポーネントを [開発](../Extensions/develop-components.md) し、[ビルド](../Desktop/building.md) することもできますし、4Dコミュニティによって共有されているパブリックコンポーネントを [GitHubで見つけて](https://github.com/search?q=4d-component\\&type=Repositories) ダウンロードすることもできます。
4D で開発する際、コンポーネントファイルはコンピューター上または Githubリポジトリ上に、透過的に保存することができます。
@@ -16,13 +16,13 @@ Components can be interpreted or [compiled](../Desktop/building.md). コンポ
- プロジェクトフォルダー (インタープリターのコンポーネント)
- または .4DZ ファイル (コンパイル済みコンポーネント)
-インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。
+インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 この場合、コンパイル済みコンポーネントのみが利用可能です。
## コンポーネントの読み込み
:::note
-このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります:
+このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります: 他の環境では、コンポーネントの管理は異なります:
- [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。
- 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。
@@ -48,7 +48,7 @@ Components can be interpreted or [compiled](../Desktop/building.md). コンポ
#### dependencies.json
-**dependencies.json** ファイルは、4Dプロジェクトに必要なすべてのコンポーネントを宣言します。 このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例:
+**dependencies.json** ファイルは、4Dプロジェクトに必要なすべてのコンポーネントを宣言します。 このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例: このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例:
```
/MyProjectRoot/Project/Sources/dependencies.json
@@ -152,7 +152,7 @@ flowchart TB
パスは、POSIXシンタックスで表します ([POSIXシンタックス](../Concepts/paths#posix-シンタックス) 参照)。
-相対パスは、[`environment4d.json`](#environment4djson) ファイルを基準とした相対パスです。 絶対パスは、ユーザーのマシンにリンクされています。
+相対パスは、[`environment4d.json`](#environment4djson) ファイルを基準とした相対パスです。 絶対パスは、ユーザーのマシンにリンクされています。 絶対パスは、ユーザーのマシンにリンクされています。
コンポーネントアーキテクチャーの柔軟性と移植性のため、ほとんどの場合、相対パスを使用することが **推奨** されます (特に、プロジェクトがソース管理ツールにホストされている場合)。
@@ -193,7 +193,7 @@ GitHub に保存されているコンポーネントは [**dependencies.json**
}
```
-... 上記の場合、"myGitHubComponent1" は宣言とパス定義の両方がされていますが、"myComponent2" は宣言されているだけです。 そのため、[**environment4d.json**](#environment4djson) ファイルにパスを定義する必要があります:
+... 上記の場合、"myGitHubComponent1" は宣言とパス定義の両方がされていますが、"myComponent2" は宣言されているだけです。 **environment4d.json** ファイルは必須ではありません。 このファイルは、**dependencies.json** ファイル内で宣言された一部またはすべてのコンポーネントのついて、**カスタムパス** を定義するのに使用します。 このファイルは、プロジェクトパッケージフォルダーまたはその親フォルダーのいずれかに保存することができます (ルートまでの任意のレベル)。
```json
{
@@ -211,7 +211,7 @@ GitHub に保存されているコンポーネントは [**dependencies.json**
GitHub ではリリースを作成するときに、**タグ** と **バージョン** を指定します。
-- **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependencyjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば:
+- **タグ** はリリースを一意に参照するテキストです。 **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependencyjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: たとえば:
```json
{
@@ -224,7 +224,7 @@ GitHub ではリリースを作成するときに、**タグ** と **バージ
}
```
-- リリースは **バージョン** によっても識別されます。 使用されるバージョニング方法は、最も一般的に使用される *セマンティックバージョニング* のコンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例:
+- リリースは **バージョン** によっても識別されます。 使用されるバージョニング方法は、最も一般的に使用される *セマンティックバージョニング* のコンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例:
```json
{
@@ -237,7 +237,7 @@ GitHub ではリリースを作成するときに、**タグ** と **バージ
}
```
-バージョンは、使用できるバージョンを定義するために使用します。 [標準的なセマンティックバージョン](https://regex101.com/r/Ly7O1x/3/) を使用します。 範囲は、最小値と最大値を示す 2つのセマンティックバージョンと演算子 ('`< | > | >= | <= | =`') で定義します。 `*` はすべてのバージョンのプレースホルダーとして使用できます。 ~ および ^ の接頭辞は、数字で始まるバージョンを定義し、それぞれ次のメジャーバージョンおよびマイナーバージョンまでの範囲を示します。
+バージョンは、使用できるバージョンを定義するために使用します。 [標準的なセマンティックバージョン](https://regex101.com/r/Ly7O1x/3/) を使用します。 範囲は、最小値と最大値を示す 2つのセマンティックバージョンと演算子 ('`< | > | >= | <= | =`') で定義します。 `*` はすべてのバージョンのプレースホルダーとして使用できます。 ~ および ^ の接頭辞は、数字で始まるバージョンを定義し、それぞれ次のメジャーバージョンおよびマイナーバージョンまでの範囲を示します。 `*` はすべてのバージョンのプレースホルダーとして使用できます。 ~ および ^ の接頭辞は、数字で始まるバージョンを定義し、それぞれ次のメジャーバージョンおよびマイナーバージョンまでの範囲を示します。
以下にいくつかの例を示します:
@@ -285,7 +285,7 @@ GitHub ではリリースを作成するときに、**タグ** と **バージ
#### 依存関係のローカルキャッシュ
-参照された GitHubコンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。 ローカルキャッシュフォルダーは以下の場所に保存されます:
+参照された GitHubコンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。 ローカルキャッシュフォルダーは以下の場所に保存されます: ローカルキャッシュフォルダーは以下の場所に保存されます:
- macOs: `$HOME/Library/Caches/This の値は実行時に代入により設定することはできません。また、呼び出されるたびに違う値となりえます。
-This command can be used in different contexts, described below. Within these contexts, you will access object/collection element properties or entity attributes through **This.<*propertyPath*\>**. For example, *This.name* or *This.employer.lastName* are valid pathes to object, element or entity properties.
+このコマンドは以下で説明するように、異なるコンテキストで使用することができます。 これらのコンテキストの中においては、**This.<*propertyPath*\>** を通してオブジェクト/コレクションの要素プロパティやエンティティの属性にアクセスすることができます。 例えば、*This.name* や*This.employer.lastName* はオブジェクト、要素やエンティティプロパティへの有効なパスとなります。
-In any other context, the command returns **Null**.
+これら以外のコンテキストにおいては、コマンドは**Null** を返します。
#### クラス関数
@@ -45,7 +45,7 @@ $o:=cs.ob.new()
$val:=$o.a //42
```
-> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。 See [this example](super.md#example-1).
+> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。 こちらの [例題](super.md#例題-1) を参照ください。
基本的に、`This` はメソッドの呼び出し元のオブジェクトを指します。
@@ -70,20 +70,20 @@ $val:=$o.f() //8
#### フォーミュラオブジェクト
-In the context of the execution of a formula object created by the [Formula](formula.md) or [Formula from string](formula-from-string.md) commands, `This` returns a reference to the object currently processed by the formula.
+[Formula](formula.md) あるいは [Formula from string](formula-from-string.md) コマンドで作成されたフォーミュラオブジェクトの実行コンテキストにおいては、`This` はフォーミュラによって現在処理されているオブジェクトへの参照を返します。
-For example, you want to use a project method as a formula encapsulated in an object:
+例えば、プロジェクトをオブジェクトのカプセル化されたフォーミュラとして使用したい場合を考えます:
```4d
var $person : Object := New object
$person.firstName:="John"
$person.lastName:="Smith"
$person.greeting:=Formula(Greeting)
- $g:=$person.greeting("hello") // returns "hello John Smith"
- $g:=$person.greeting("hi") // returns "hi John Smith"
+ $g:=$person.greeting("hello") // "hello John Smith" を返す
+ $g:=$person.greeting("hi") // "hi John Smith" を返す
```
-With the *Greeting* project method:
+*Greeting* プロジェクトメソッドの中身は以下のようになっています:
```4d
#DECLARE($greeting : Text) : Text
@@ -92,17 +92,17 @@ With the *Greeting* project method:
#### リストボックス
-In the context of a list box associated to a collection or an entity selection, during the [`On Display Detail`](../Events/onDisplayDetail.md) or the [`On Data Change`](../Events/onDataChange.md) events, `This` returns a reference to the collection element or entity accessed by the list box to display the current row.
+コレクションまたはエンティティセレクションに割り当てられたリストボックスのコンテキストにおいては、[`On Display Detail`](../Events/onDisplayDetail.md) あるいは [`On Data Change`](../Events/onDataChange.md) イベントの最中において、は現在の行を表示するためにリストボックス割り当てられたコレクション要素またはエンティティへの参照を返します。
:::note
-If you use a collection of scalar values in a list box, 4D creates an object for each element with a single **value** property. Thus, the element value is returned by the **This.value** non-assignable expression.
+スカラー値のコレクションをリストボックスに対して使用した場合、4D はそれぞれの要素に対して、単一のプロパティ**value** を持つオブジェクトを作成します。 Thus, the element value is returned by the **This.value** non-assignable expression. そのため、要素の値は**This.value** という代入不可の式によって返されます。
:::
#### 例題 1
-A collection of objects, each with this structure:
+以下のような構造を持つオブジェクトのコレクションがある場合を考えます:
```json
{
@@ -127,14 +127,14 @@ A collection of objects, each with this structure:
```
-In the list box, each column refers to one of the properties of the object, either directly (This.name), indirectly (This.employees.length), or through an expression (*getPicture*) in which can be used directly. The list box looks like:
+リストボックス内では、各カラムはオブジェクトのプロパティいずれか一つを、直接的(This.name) に、あるいは間接的(This.employees.length) に、あるいは直接使用できる式(*getPicture*) を通して参照しています。 このリストボックスは、以下のようになります: このリストボックスは、以下のようになります:
-The *GetPicture* project method is automatically executed during the **On display detail** event:
+*GetPicture* プロジェクトメソッドは、**On display detail** イベント中に自動的に実行されます:
```4d
- //GetPicture Method
+ //GetPicture メソッド
#DECLARE -> $genderPict : Picture
If(This.isFemale)
$genderPict:=Form.genericFemaleImage
@@ -143,34 +143,34 @@ The *GetPicture* project method is automatically executed during the **On displa
End if
```
-Once the form is executed, you can see the result:
+フォームを実行すると、以下のような結果が表示されます:
#### 例題 2
-You want to display entities from the following structure in a list box:
+以下のようなストラクチャーからのエンティティをリストボックスに表示したい場合を考えます:
-You build a list box of the "Collection or entity selection" type with the following definition:
+その場合、以下のような定義を持つ"コレクションまたはエンティティセレクション"型のリストボックスを作成します:
注:
-- *This.ID*, *This.Title* and *This.Date* directly refers to the corresponding attributes in the ds.Event dataclass.
-- *This.meetings* is a related attribute (based upon the One To Many relation name) that returns an entity selection of the ds.Meeting dataclass.
-- **Form.eventList** is the entity selection that is attached to the list box. The initialization code can be put in the on load form event:
+- *This.ID*、*This.Title* および *This.Date* は、ds.Event データクラス内の対応する属性を直接参照します。
+- *This.meetings* は(1対N リレーション名に基づいた)リレーション属性であり、ds.Meeting データクラスのエンティティセレクションを返します。
+- **Form.eventList** はリストボックスに割り当てられているエンティティセレクションです。 初期化コードは、On Load フォームイベント内で以下のように書くことができます: 初期化コードは、On Load フォームイベント内で以下のように書くことができます:
```4d
Case of
:(Form event code=On Load)
- Form.eventList:=ds.Event.all() //returns an entity selection with all entities
+ Form.eventList:=ds.Event.all() //全てのエンティティを格納したエンティティセレクションを返す
End case
```
-Once the form is executed, the list box is automatically filled with the entity selection:
+フォームが実行されると、リストボックスにはエンティティセレクションが入った状態で表示されます:
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/use-entity-selection.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/use-entity-selection.md
index 2dc0fd7758d0f8..1b60f7c8013bcd 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/use-entity-selection.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/use-entity-selection.md
@@ -16,7 +16,7 @@ displayed_sidebar: docs
#### 説明
-The `USE ENTITY SELECTION` command updates the current selection of the table matching the dataclass of the *entitySelection* parameter, according to the content of the entity selection.
+`USE ENTITY SELECTION` コマンドは、*entitySelection* 引数のデータクラスに合致するテーブルのカレントセレクションを、渡したエンティティセレクションの内容で更新します。
[リモートデータストア](../ORDA/remoteDatastores.md) の場合は、このコマンドは使用できません。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server-list.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server-list.md
index 26a265e12f6bf5..342f4650eda288 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server-list.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server-list.md
@@ -8,9 +8,9 @@ displayed_sidebar: docs
-| 引数 | 型 | | 説明 |
-| --- | ---------- | - | ---------------------------------------------- |
-| 戻り値 | Collection | ← | Collection of the available Web Server objects |
+| 引数 | 型 | | 説明 |
+| --- | ---------- | - | -------------------------- |
+| 戻り値 | Collection | ← | 利用可能なWeb サーバーオブジェクトのコレクション |
@@ -33,9 +33,9 @@ displayed_sidebar: docs
サーバーが実際に実行中か否かに関わらず、`WEB Server list` コマンドは利用可能な Webサーバーをすべて返します。
-> デフォルトの Webサーバーオブジェクトは、4D 起動時に自動的にロードされます。 On the other hand, each component Web server that you want to use must be instantiated using the [`WEB Server`](web-server.md) command.
+> デフォルトの Webサーバーオブジェクトは、4D 起動時に自動的にロードされます。 一方で、使用したいコンポーネントのWeb サーバーは、[`WEB Server`](web-server.md) コマンドによってそれぞれインスタンス化されている必要があります。
-You can use the [.name](../API/WebServerClass.md#name) property of the Web server object to identify the project or component to which each Web server object in the list is attached.
+Webサーバオブジェクトの [.name](../API/WebServerClass.md#name) プロパティを使用することで、リスト内の各 Webサーバーオブジェクトが関連づけられているデータベースまたはコンポーネントを識別することができます。
#### 例題
@@ -47,7 +47,7 @@ You can use the [.name](../API/WebServerClass.md#name) property of the Web serve
$wSList:=WEB Server list
$vRun:=$wSList.countValues(True;"isRunning")
- ALERT(String($vRun)+" web server(s) running on "+String($wSList.length)+" available.")
+ ALERT(String($wSList.length)+" 個のリストの中で、"+String($vRun)+" 個の Web サーバーが実行中です。")
```
#### 参照
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server.md
index 7cbd5b845487e6..01bb277fab8cf4 100644
--- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server.md
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/web-server.md
@@ -15,7 +15,7 @@ displayed_sidebar: docs
-*This command is not thread-safe, it cannot be used in preemptive code.*
+*このコマンドはスレッドセーフではないので、プリエンプティブなコードでは使用できません。*
| Tipo de propriedade | Descrição |
|---|---|
| String (cadeia de caracteres) | attributePath expresso usando a notação de ponto, por exemplo, "name" ou "user.address.zipCode" |
| Coleção de cadeias de caracteres | Cada cadeia de caracteres da coleção representa um nível de attributePath, por exemplo, \["name"] ou \["user", "address", "zipCode"]. Using a collection allows querying on attributes with names that are not compliant with dot notation, e.g. \["4Dv17.1","en/fr"] |
| Tipo | Descrição |
|---|---|
| String | attributePath expresso usando a notação de ponto, por exemplo, "nome" ou "usuario.endereco.cep" |
| Coleção de strings | Cada string da coleção representa um nível do attributePath, por exemplo, \["nome"] ou \["usuario","endereco","cep"]. Using a collection allows querying on attributes with names that are not compliant with dot notation, e.g. \["4Dv17.1","en/fr"] |
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostname | texto | Endereço IP ou nome do datastore remoto + ":" + número da porta |
| tls | booleano | True se a conexão segura é usada com o datastore remoto |
| idleTimeout | número | Tempo limite de inatividade da sessão (em minutos) |
| user | texto | Usuário autenticado no datastore remoto |
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostname | texto | Endereço IP ou nome do datastore remoto + ":" + número da porta |
| tls | booleano | True se a conexão segura é usada com o datastore remoto |
| idleTimeout | número | Tempo limite de inatividade da sessão (em minutos) |
| user | texto | Usuário autenticado no datastore remoto |
A standard **Save** dialog appears so you can choose the name and location of the 4D project's main folder. 3. Introduzca el nombre de su carpeta de proyecto y haga clic en **Guardar**. Este nome será utilizado: @@ -72,7 +72,7 @@ Además de las opciones sistema estándar, la caja de diálogo _Abrir_ de 4D ofr ### Abrir um projeto com um ficheiro 4DLink -You can use a [`.4DLink` file](#about-4DLink-files) to launch the 4D application and open the target 4D project. Há duas formas de o fazer: +Você pode usar um [arquivo `.4DLink`](#about-4DLink-files) para iniciar a aplicação 4D e abrir o projeto alvo 4D. Há duas formas de o fazer: - haga doble clic o arrastre y suelte el archivo `.4DLink` en la aplicación 4D - vaya a **Archivo** > **Abrir los proyectos recientes** y seleccione un proyecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Menus/creating.md b/i18n/pt/docusaurus-plugin-content-docs/current/Menus/creating.md index 01caa80ee01cba..7ac3f0bc271bd4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Menus/creating.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Menus/creating.md @@ -57,8 +57,8 @@ Para adicionar um item de menu: 1. In the list of source menus, select the menu to which you want to add a command. Se o menu já contiver comandos, eles serão exibidos na lista central. If you want to insert the new command, select the command that you want it to appear above. Você sempre pode reorganizar o menu posteriormente, arrastando e soltando. 2. Elija **Añadir un elemento al menú "NombreDelMenú"** en el menú de opciones del editor o desde el menú contextual (clic derecho en la lista central). - OR - Click on the add  button located below the central list. + OU + Clique no botão adicionar  localizado abaixo da lista central. 4D adds a new item with the default name “Item X” where X is the number of items already created. 3. Double-click on the name of the command in order to switch it to editing mode and enter a custom name. OR Enter the custom name in the "Title" area. Pode conter até 31 caracteres. Você pode digitar o nome como "código duro" ou insira uma referência (veja abaixo). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md b/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md index 6ae17f56507694..0648d15226ebe0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -13,9 +13,12 @@ Read [**What’s new in 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-v20-R - Expressions used in [form object properties](../FormObjects/properties_Reference.md) now benefit from syntax checking in the [Property list](../FormEditor/formEditor.md#property-list) and in the [Compiler](../Project/compiler.md#check-syntax). - You can [associate a class to a form](../FormEditor/properties_FormProperties.md#form-class) to enable code type-ahead and automatic instantiation of form data when using the [`Form`](../commands/form.md) command. - Support of [standalone sessions](../API/SessionClass.md) to simplify local coding for client/server applications. +- [4D debugger](../Debugging/debugger.md): new design and auto-save, display mode features. - [New built component architecture](../Desktop/building.md#build-component) for a better compliance with Apple notarization guidelines. +- Dependencies: Use the Dependency manager to [check for new versions](../Project/components.md#checking-for-new-versions) and [update](../Project/components.md#updating-dependencies) GitHub components. - 4D Language: - - Modified commands: [`FORM EDIT`](../commands/form-edit.md) + - Comandos modificados: [`FORM EDIT`](../commands/form-edit.md) + - [`.sign()`](../API/CryptoKeyClass.md#sign) and [`.verify()`](../API/CryptoKeyClass.md#verify) functions of the [4D.CryptoKey class](../API/CryptoKeyClass.md) support Blob in the _message_ parameter. - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R8): list of all bugs that have been fixed in 4D 20 R8. #### Mudanças de comportamento @@ -29,12 +32,12 @@ Leia [**O que há de novo no 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - As colunas e cabeçalhos da list box de tipo tempo agora suportam a opção ["blankIfNull"](../FormObjects/properties_Display.md#time-format). -- New properties in [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Novas propriedades em [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) e [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - Agora você pode [adicionar e remover componentes usando a interface do gerenciador de componentes](../Project/components.md#adding-and-removing-dependencies). - New [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) in which you declare all variables and parameters in your code using `var` and `#DECLARE`/`Function` keywords (only mode supported in new projects). [Syntax checking feature](../Project/compiler.md#check-syntax) has been enhanced accordingly. - Support of [Session singletons](../Concepts/classes.md#singleton-classes) and new [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) Class property. - New [`onHttpGet` function keyword](../ORDA/ordaClasses.md#onhttpget-keyword) to define singleton or ORDA functions that can be called through [HTTP REST GET requests](../REST/ClassFunctions.md#function-calls). -- New [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) class for the REST server to return any web contents. +- Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. - Qodly Studio: You can now [attach the Qodly debugger to 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - New Build Application keys for remote 4D applications to validate the server certificate authority [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) and/or [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - 4D Language: @@ -50,6 +53,7 @@ Leia [**O que há de novo no 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d- - Documentations for [4D Language](../commands/command-index.md) and [4D Write Pro Language](../WritePro/commands/command-index.md) are now fully available on developer.4d.com. Find out about all the new features and changes concerning these documentations in this release note. - The [`File`](../commands/file.md) command (as well as [`4D.File.new()`](../API/FileClass.md#4dfilenew)) is stricter when it comes to checking the syntax of the _path_ supplied as a parameter. +- The **describe** action [permission](../ORDA/privileges.md#permission-actions) has been removed from available actions. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Session _describe_ privileges are now ignored. ## 4D 20 R6 @@ -63,11 +67,11 @@ Leia [**O que há de novo no 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d- - New [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) function and [`$clean`](../REST/$clean.md) REST API to get a new entity selection based upon the original entity selection but without its deleted entities. - New [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) function and [`$info/privileges`](../REST/$info.md) REST API to inspect session privileges for an easier debugging. - New [4DCEFParameters.json file](../FormObjects/webArea_overview.md#4dcefparametersjson) to customize 4D embedded web areas. -- New [HTTPAgent](../API/HTTPAgentClass.md) class and new [`agent`](../API/HTTPRequestClass.md#options-parameter) property for HTTPRequest class. +- Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. - New [`enableState()`](../API/WebFormClass.md) and [`disableState()`](../API/WebFormClass.md) functions to monitor Qodly page states from the server. - New [`$singleton` API](../REST/$singleton.md) to call exposed singleton functions from REST and new [associated privileges](../ORDA/privileges.md). - Um [novo botão de configurações](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) ajuda você a atualizar seu projeto para usar o modo REST de "login forçado" (o método de banco de dados `On REST Authentication` agora está obsoleto). -- A [new settings tab](../Project/compiler.md#warnings) helps you define warnings generation globally. +- Uma [nova guia de parametros](../Project/compiler.md#warnings) ajuda a definir a geração de avisos globalmente. - Several commands, mainly from the "4D Environment" theme, are now thread-safe ([see the full list](https://doc.4d.com/4Dv20R6/4D/Preemptive_6957385.999-2878208.en.html)), as well as some selectors of the [`SET DATABASE PARAMETER`](https://doc.4d.com/4dv20R/help/command/en/page642.html)/[`Get database parameter`](https://doc.4d.com/4dv20R/help/command/en/page643.html) commands. - New [4D-QPDF component](https://github.com/4d/4D-QPDF) that provides the `PDF Get attachments` command to extract attachments from a PDF/A3 document. - Comandos da linguagem 4D: [página Novidades](https://doc.4d.com/4Dv20R6/4D/20-R6/What-s-new.901-6957482.en.html) em doc.4d.com. @@ -93,7 +97,7 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- - Suporte à [inicializando uma propriedade de classe em sua linha de declaração](../Concepts/classes.md/#initializing-the-property-in-the-declaration-line). - Novo modo [forçar login para solicitações REST](../REST/authUsers.md#force-login-mode) com um suporte específico [no Qodly Studio para 4D](../WebServer/qodly-studio.md#force-login). - Nuevo parámetro REST [$format](../REST/$format.md). -- [`Session`](../commands/session.md) object is now available in remote user sessions and stored procedures session. +- O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. - Comandos da linguagem 4D: [página Novidades](https://doc.4d.com/4Dv20R5/4D/20-R5/What-s-new.901-6817247.en.html) em doc.4d.com. - 4D Write Pro: [What's new page](https://doc.4d.com/4Dv20R5/4D/20-R5/What-s-new.901-6851780.en.html) on doc.4d.com. - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. @@ -101,7 +105,7 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- #### Mudanças de comportamento - Os plug-ins _4D Internet Commands_ e _4D for OCI_ não estão mais incluídos nos instaladores do 4D. Para obter esses plug-ins, você precisa se conectar ao [**Portal de descarrega de produtos 4D**](https://product-download.4d.com/). -- Changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) are now saved in a separate file named `catalog_editor.json` stored in the project's [`Sources`](../Project/architecture.md#sources) folder. +- Changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) agora são salvas em um arquivo separado chamado `catalog_editor.json` armazenado na pasta [`Sources`](../Project/architecture.md#sources) do projeto. ## 4D 20 R4 @@ -109,15 +113,15 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d #### Destaques -- Support of [`ECDSA` encryption format](../Admin/tls.md#encryption) for TLS certificates. +- Suporte do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. - Client/server and SQL server TLS connections are now [configured dynamically](../Admin/tls.md#enabling-tls-with-the-other-servers) (no certificate files are required). - Direct HTML format for [structure definition exports](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - New [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) that enhances code control during code typing, syntax checking, and compilation steps to prevent execution errors. - Method parameters declared in `#DECLARE` prototypes are [no longer necessary in "Compiler_" methods](../Concepts/parameters.md#compilation). - Suporte de [formatos personalizados de data e hora](../Project/date-time-formats.md) -- New [`Try(expression)` keyword](../Concepts/error-handling.md#tryexpression) to handle simple error cases. +- Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. - Novo comando [`HTTP Parse message`](../API/HTTPRequestClass.md#http-parse-message). -- New [Non-blocking printing](../settings/compatibility.md) compatibility option. +- Nova opção de compatibilidade [Impressão sem bloqueio](../settings/compatibility.md). - Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. - Comandos da linguagem 4D: [Novidades de página](https://doc.4d.com/4Dv20R4/4D/20-R4/What-s-new.901-6655756.en.html) em doc.4d.com. - 4D Write Pro: [Página Novidades] (https://doc.4d.com/4Dv20R4/4D/20-R4/What-s-new.901-6683440.en.html) em doc.4d.com. @@ -128,7 +132,7 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d - Usando uma sintaxe legada para declarar parâmetros (por exemplo, `C_TEXT($1)` ou `var $1 : Text`) está agora obsoleto e gera avisos na digitação de código, verificação de sintaxe e etapas de compilação. - La coherencia de las selecciones ahora se mantiene después de que se hayan eliminado algunos registros y se hayan creado otros (ver [esta entrada de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). - In the updated [OpenSSL library](#library-table), the default SSL/TLS security level has been changed from 1 to 2. Chaves RSA, DSA e DH de 1024 bits ou mais e menos de 2048 bits, assim como chaves ECC de 160 bits ou mais e menos de 224 bits, agora não são mais permitidas. Por padrão, a compressão TLS já estava desativada nas versões anteriores do OpenSSL. No nível de segurança 2, ele não pode ser habilitado. -- In order to allow password verification when the [4D user directory uses the bcrypt algorithm](https://blog.4d.com/bcrypt-support-for-passwords/), the "password" value in the _connectionInfo_ parameter of the [`Open datastore`](../commands/open-datastore.md) command is now sent in clear form by default. Make sure your "On REST authentication" database method can handle passwords in clear form (third parameter is then **False**) and that `Open datastore` encrypts your connection by passing the "tls" option to **True** in _connectionInfo_. In specific cases, a new "passwordAlgorithm" option can also be used for compatibility (see [`Open datastore`](../commands/open-datastore.md) command). +- Make sure your "On REST authentication" database method can handle passwords in clear form (third parameter is then **False**) and that `Open datastore` encrypts your connection by passing the "tls" option to **True** in _connectionInfo_. In order to allow password verification when the [4D user directory uses the bcrypt algorithm](https://blog.4d.com/bcrypt-support-for-passwords/), the "password" value in the _connectionInfo_ parameter of the [`Open datastore`](../commands/open-datastore.md) command is now sent in clear form by default. In specific cases, a new "passwordAlgorithm" option can also be used for compatibility (see [`Open datastore`](../commands/open-datastore.md) command). ## 4D 20 R3 @@ -167,11 +171,11 @@ Se suas aplicações 4D utilizam conexões TLS, é recomendado que você faça a #### Destaques - New [WebSocket class](../API/WebSocketClass.md) to create and manage client WebSocket connections from 4D. -- New QUIC network layer [interface setting](../settings/client-server.md#network-layer). +- Nova [configuração de interface] (../settings/client-server.md#network-layer) para a camada de rede QUIC. - 4D View Pro: soporte del formato de archivo **.sjs** para [la importación](../ViewPro/commands/vp-import-document) y la [exportación](../ViewPro/commands/vp-export-document) de documentos. - Comandos da linguagem 4D: [Novidades de página](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.en.html) em doc.4d.com. - 4D Write Pro: [Página Novidades] (https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6390313.en.html) em doc.4d.com. -- 4D Write Pro Interface: New [Table Wizard](../WritePro/writeprointerface.md). +- Interface 4D Write Pro: novo [Table Wizard](../WritePro/writeprointerface.md). - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos os bugs corrigidos em 4D 20 R2. #### Mudanças de comportamento diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/entities.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/entities.md index 6e6717207aacc5..140c254821522f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/entities.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/entities.md @@ -90,7 +90,7 @@ Puede manejar las entidades como cualquier otro objeto en 4D y pasar sus referen :::info -Com as entidades, não há o conceito de "registro atual" como na linguagem 4D. Pode utilizar tantas entidades quantas as necessárias, em simultâneo. There is also no automatic lock on an entity (see [Entity locking](#entity-locking)). When an entity is loaded, it uses the [lazy loading](glossary.md#lazy-loading) mechanism, which means that only the needed information is loaded. No entanto, no cliente/servidor, a entidade pode ser carregada automaticamente de forma direta, se necessário. +Com as entidades, não há o conceito de "registro atual" como na linguagem 4D. Pode utilizar tantas entidades quantas as necessárias, em simultâneo. Não há também bloqueio automático em uma entidade (veja [bloqueio de Entity](#entity-locking)). When an entity is loaded, it uses the [lazy loading](glossary.md#lazy-loading) mechanism, which means that only the needed information is loaded. No entanto, no cliente/servidor, a entidade pode ser carregada automaticamente de forma direta, se necessário. ::: @@ -238,7 +238,7 @@ Você pode atribuir ou modificar o valor de um "1" atributo da entidade relacion Puede crear un objeto de tipo [entity selection](dsMapping.md#entity-selection) de la siguiente manera: - Lance una búsqueda en las entidades [en una dataclass](API/DataClassClass.md#query) o en una [selección de entidades existente](API/EntitySelectionClass.md#query); -- Using the [`.all()`](API/DataClassClass.md#all) dataclass function to select all the entities in a dataclass; +- Usando a função dataclass [`.all()`](API/DataClassClassClass.md#all), para selecionar todas as entidades em um dataclass; - Using the [`Create entity selection`](../commands/create-entity-selection.md) command or the [`.newSelection()`](API/DataClassClass.md#newselection) dataclass function to create a blank entity selection; - Usando a [`.copy()`](API/EntitySelectionClass.md#copy) função para duplicar uma seleção de entidade existente; - Using one of the various functions from the [Entity selection class](API/EntitySelectionClass.md) that returns a new entity selection, such as [`.or()`](API/EntitySelectionClass.md#or); @@ -270,12 +270,12 @@ Una entity selection **compartible** tiene las siguientes características: - it can be stored in several shared objects or collections, or in a shared object or collection which already belongs to a group; - não permite a adição de novas entidades. A tentativa de adicionar uma entidade a uma seleção de entidade compartilhável acionará um erro (1637 - Esta seleção de entidade não pode ser alterada). To add an entity to a shareable entity selection, you must first transform it into a non-shareable entity selection using the [`.copy()`](API/EntitySelectionClass.md#copy) function, before calling [`.add()`](API/EntitySelectionClass.md#add). -> Most entity selection functions (such as [`.slice()`](API/EntitySelectionClass.md#slice), [`.and()`](API/EntitySelectionClass.md#and)...) support shareable entity selections since they do not need to alter the original entity selection (they return a new one). +> A maioria das funções de seleção de entidades (como [`.slice()`](API/EntitySelectionClass.md#slice), [`.and()`](API/EntitySelectionClass.md#and)...) support shareable entity selections since they do not need to alter the original entity selection (they return a new one). Una entity selection **modificable** tiene las siguientes características: - não pode ser compartilhado entre processos, nem armazenado em um objeto ou coleção compartilhada. A tentativa de armazenar uma seleção de entidade não compartilhável em um objeto ou coleção compartilhada acionará um erro (-10721 - Tipo de valor não suportado em um objeto compartilhado ou coleção compartilhada); -- it accepts the addition of new entities, i.e. it is supports the [`.add()`](API/EntitySelectionClass.md#add) function. +- ele aceita a adição de novas entidades, ou seja, suporta a função [`.add()`](API/EntitySelectionClass.md#add). #### Como é que são definidos? @@ -334,7 +334,7 @@ $comp2:=$lowSal.employer //$comp2 is alterable because $lowSal is alterable :::note Entity selections devolvidas pelo servidor -In client/server architecture, entity selections returned from the server are always shareable on the client, even if [`copy()`](API/EntitySelectionClass.md#copy) was called on the server. To make such an entity selection alterable on the client, you need to execute [`copy()`](API/EntitySelectionClass.md#copy) on the client side. Exemplo: +In client/server architecture, entity selections returned from the server are always shareable on the client, even if [`copy()`](API/EntitySelectionClass.md#copy) was called on the server. Para tornar essa seleção de entidade alterável no cliente, você precisa executar [`copy()`](API/EntitySelectionClass.md#copy) no lado do cliente. Exemplo: ```4d //a function is always executed on the server @@ -530,7 +530,7 @@ Los filtros no se aplican a las selecciones heredadas de registros manejadas a t | [entity.attributeName](../API/EntityClass.md#attributename) | Filtro aplicado si _attributeName_ corresponde a entidades relacionadas de una clase de datos filtrada (incluyendo alias o atributo calculado) | | [Create entity selection](../commands/create-entity-selection.md) | | -Other ORDA functions accessing data do not directly trigger the filter, but they nevertheless benefit from it. For example, the [`entity.next()`](../API/EntityClass.md#next) function will return the next entity in the already-filtered entity selection. On the other hand, if the entity selection is not filtered, [`entity.next()`](../API/EntityClass.md#next) will work on non-filtered entities. +Other ORDA functions accessing data do not directly trigger the filter, but they nevertheless benefit from it. Por exemplo, a função [`entity.next()`](../API/EntityClass.md#next) retornará a próxima entidade na seleção de entidade já filtrada. Por outro lado, se a seleção de entidade não estiver filtrada, [`entity.next()`](../API/EntityClass.md#next) funcionará em entidades não filtradas. :::note diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md index 9f726a4360ebcc..733e4d18006750 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md @@ -26,7 +26,7 @@ No confunda el **sello de modificación global** con el **sello de entidad** int ## Configurando rastreamento de alterações de dados -By default, the global modification stamp is not created (the [`.getGlobalStamp()`](../API/DataStoreClass.md#getglobalstamp) function returns 0. To enable data change tracking, you need to add special fields and a table to your structure. You can use the contextual menu of the Structure Editor to create automatically all necessary elements. +Por padrão, o carimbo de modificação global não é criado (a função [`.getGlobalStamp()`](../API/DataStoreClass.md#getglobalstamp) retorna 0. To enable data change tracking, you need to add special fields and a table to your structure. You can use the contextual menu of the Structure Editor to create automatically all necessary elements. ### Requisitos de estrutura diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/glossary.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/glossary.md index 4638a279249305..fe023e9dde6395 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/glossary.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/glossary.md @@ -9,7 +9,7 @@ title: Glossary ## Ação -Todas las acciones que pueden realizarse en un [recurso](#resource). As ações disponíveis são: criar, ler, atualizar, largar, executar, promover e descrever. +Todas las acciones que pueden realizarse en un [recurso](#resource). Available actions are: create, read, update, drop, execute, and promote. ## Atributo diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/ordaClasses.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/ordaClasses.md index 50b7119094f4a5..ae5b45dc2373fa 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/ordaClasses.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/ordaClasses.md @@ -847,7 +847,7 @@ As this type of call is an easy offered action, the developer must ensure no sen ### params -A function with `onHttpGet` keyword accepts [parameters](../Concepts/parameters.md). +Uma função com a palavra-chave `onHttpGet` aceita [parâmetros](../Concepts/parameters.md). In the HTTP GET request, parameters must be passed directly in the URL and declared using the `$params` keyword (they must be enclosed in a collection). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/privileges.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/privileges.md index a85887f7e28bcb..fde7f94459a87a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/privileges.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/privileges.md @@ -49,15 +49,14 @@ Permissões controlam o acesso a objetos ou funções de armazenamento de dados. As ações disponíveis estão relacionadas com o recurso alvo. -| Acções | armazém de dados | dataclass | atributo | função de modelo de dados ou função singleton | -| ------------ | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **create** | Criar entidade em qualquer classe de dados | Criar entidade nesta classe de dados | Criar uma entidade com um valor diferente do valor padrão permitido para este atributo (ignorado para atributos de alias). | n/a | -| **read** | Ler atributos em qualquer dataclass | Ler atributos nesta classe de dados | Leia o conteúdo desse atributo | n/a | -| **update** | Atualizar atributos em qualquer classe de dados. | Atualiza os atributos nesta classe de dados. | Atualiza o conteúdo deste atributo (ignorado para atributos alias). | n/a | -| **drop** | Eliminar dados em qualquer classe de dados. | Eliminar dados nesta classe de dados. | Excluir um valor não nulo para este atributo (exceto para alias e atributo calculado). | n/a | -| **execute** | Executar qualquer função no projeto (datastore, dataclass, seleção de entidade, entidade) | Executa qualquer função na classe de dados. Funções de Dataclass e funções de seleção de entidades, e funções de seleção de entidades são tratadas como funções de dataclass | n/a | Executar esta função | -| **describe** | Todas as classes de dados estão disponíveis na /rest/$catalog API | Esta dataclass está disponível na API /rest/$catalog | Esse atributo está disponível na API /rest/$catalog. | Esta função de dataclass está disponível na API /rest/$catalog (não disponível com singletons) | -| **promote** | n/a | n/a | n/a | Associa um determinado privilégio durante a execução da função. O privilégio é temporariamente adicionado à sessão e removido no final da execução da função. Por segurança, só o processo de execução da função é acrescentado o privilégio, não toda a sessão. | +| Acções | armazém de dados | dataclass | atributo | função de modelo de dados ou função singleton | +| ----------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **create** | Criar entidade em qualquer classe de dados | Criar entidade nesta classe de dados | Criar uma entidade com um valor diferente do valor padrão permitido para este atributo (ignorado para atributos de alias). | n/a | +| **read** | Ler atributos em qualquer dataclass | Ler atributos nesta classe de dados | Leia o conteúdo desse atributo | n/a | +| **update** | Atualizar atributos em qualquer classe de dados. | Atualiza os atributos nesta classe de dados. | Atualiza o conteúdo deste atributo (ignorado para atributos alias). | n/a | +| **drop** | Eliminar dados em qualquer classe de dados. | Eliminar dados nesta classe de dados. | Excluir um valor não nulo para este atributo (exceto para alias e atributo calculado). | n/a | +| **execute** | Executar qualquer função no projeto (datastore, dataclass, seleção de entidade, entidade) | Executa qualquer função na classe de dados. Funções de Dataclass e funções de seleção de entidades, e funções de seleção de entidades são tratadas como funções de dataclass | n/a | Executar esta função | +| **promote** | n/a | n/a | n/a | Associa um determinado privilégio durante a execução da função. O privilégio é temporariamente adicionado à sessão e removido no final da execução da função. Por segurança, só o processo de execução da função é acrescentado o privilégio, não toda a sessão. | **Notas:** @@ -67,10 +66,7 @@ As ações disponíveis estão relacionadas com o recurso alvo. - Valores padrão: na implementação atual, apenas _Null_ está disponível como valor padrão. - No REST [modo de login](../REST/authUsers.md/#force-login-mode), a [função `authentify()`](../REST/authUsers.md#function-authentify) é sempre executável por usuários convidados, independentemente da configuração das permissões. -A definição das permissões deve ser coerente, nomeadamente: - -- Permissões de **atualização** e **drop** também precisam da permissão **read** (mas **create** não precisa dela) -- Para funções do modelo de dados, permissão de **promoção** também precisa de permissão **descrever**. +Setting permissions requires to be consistent, in particular **update** and **drop** permissions also need **read** permission (but **create** does not need it). ## Privilégios e roles @@ -139,7 +135,6 @@ O arquivo padrão tem o seguinte conteúdo: "create": ["none"], "update": ["none"], "drop": ["none"], - "describe": ["none"], "execute": ["none"], "promote": ["none"] } @@ -175,26 +170,25 @@ No Qodly Studio para 4D, o modo pode ser definido usando a opção [**Forçar lo A sintaxe do arquivo `roles.json` é a seguinte: -| Nome da propriedade | | | Tipo | Obrigatório | Descrição | -| ------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | -| privileges | | | Coleção de objetos de 'privilégio' | X | Lista de privilégios definidos | -| | \[].privilege | | Text | | Nome do privilégio | -| | \[].includes | | Coleção de strings | | Lista de nomes de privilégios incluídos | -| roles | | | Coleção de objetos `papel` | | Lista de roles definidos | -| | \[].role | | Text | | Nome da role | -| | \[].privileges | | Coleção de strings | | Lista de nomes de privilégios incluídos | -| permissions | | | Object | X | Lista de acções permitidas | -| | allowed | | Colección de objetos `permission` | | Lista de permissões permitidas | -| | | \[].applyTo | Text | X | Targeted [resource](#resources) name | -| | | \[].type | Text | X | [Resource](#resources) type: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | -| | | \[].read | Coleção de strings | | Lista de privilégios | -| | | \[].create | Coleção de strings | | Lista de privilégios | -| | | \[].update | Coleção de strings | | Lista de privilégios | -| | | \[].drop | Coleção de strings | | Lista de privilégios | -| | | \[].describe | Coleção de strings | | Lista de privilégios | -| | | \[].execute | Coleção de strings | | Lista de privilégios | -| | | \[].promote | Coleção de strings | | Lista de privilégios | -| forceLogin | | | Parâmetros | | True para habilitar el [modo "forceLogin"](../REST/authUsers.md#force-login-mode) | +| Nome da propriedade | | | Tipo | Obrigatório | Descrição | +| ------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | +| privileges | | | Coleção de objetos de 'privilégio' | X | Lista de privilégios definidos | +| | \[].privilege | | Text | | Nome do privilégio | +| | \[].includes | | Coleção de strings | | Lista de nomes de privilégios incluídos | +| roles | | | Coleção de objetos `papel` | | Lista de roles definidos | +| | \[].role | | Text | | Nome da role | +| | \[].privileges | | Coleção de strings | | Lista de nomes de privilégios incluídos | +| permissions | | | Object | X | Lista de acções permitidas | +| | allowed | | Colección de objetos `permission` | | Lista de permissões permitidas | +| | | \[].applyTo | Text | X | Targeted [resource](#resources) name | +| | | \[].type | Text | X | [Resource](#resources) type: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | +| | | \[].read | Coleção de strings | | Lista de privilégios | +| | | \[].create | Coleção de strings | | Lista de privilégios | +| | | \[].update | Coleção de strings | | Lista de privilégios | +| | | \[].drop | Coleção de strings | | Lista de privilégios | +| | | \[].execute | Coleção de strings | | Lista de privilégios | +| | | \[].promote | Coleção de strings | | Lista de privilégios | +| forceLogin | | | Parâmetros | | True para habilitar el [modo "forceLogin"](../REST/authUsers.md#force-login-mode) | :::caution Lembrete @@ -254,9 +248,6 @@ A boa prática é manter todo o acesso aos dados bloqueado por padrão graças a "execute": [ "none" ], - "describe": [ - "none" - ], "promote": [ "none" ] diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md index 3471df94d3ab52..31afa0f5d2e3c9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md @@ -49,7 +49,7 @@ Os recursos do ORDA relacionados ao bloqueio de entidades e à transação são - Si un proceso bloquea una entidad de un datastores remoto, la entidad se bloquea para todos los otros procesos, incluso cuando estos procesos comparten la misma sesión (ver [Bloqueo de entidades](entities.md#entity-locking)). Se várias entidades que apontam para um mesmo registro tiverem sido bloqueadas em um processo, todas elas deverão ser desbloqueadas no processo para remover o bloqueio. Se um bloqueio tiver sido colocado em uma entidade, o bloqueio será removido quando não houver mais referência a essa entidade na memória. - Las transacciones pueden iniciarse, validarse o cancelarse por separado en cada almacén de datos remoto mediante las funciones `dataStore.startTransaction()`, `dataStore.cancelTransaction()` y `dataStore.validateTransaction()`. Não têm impacto noutros datastores. -- Los comandos clásicos del lenguaje 4D (`START TRANSACTION`, `VALIDATE TRANSACTION`, `CANCEL TRANSACTION`) sólo se aplican al datastore principal (devuelto por `ds`). +- Classic 4D language commands ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) only apply to the main datastore (returned by `ds`). Se uma entidade de um datastore remoto é segurada por uma transação em um processo, outros processos não podem atualizá-lo, mesmo que esses processos compartilhem a mesma sessão. - Os bloqueios nas entidades são removidos e as transações são anuladas: - quando o processo é eliminado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Project/architecture.md b/i18n/pt/docusaurus-plugin-content-docs/current/Project/architecture.md index 84a4a69c74ce89..0c7d0433b43ff2 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Project/architecture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Project/architecture.md @@ -62,7 +62,7 @@ This text file can also contain configuration keys, in particular [`"tokenizedTe | tips.json | Dicas definidas | JSON | | lists.json | Listas definidas | JSON | | filters.json | Filtros definidos | JSON | -| dependencies.json | Names of [components to load](components.md) in the project | JSON | +| dependencies.json | Nomes de [componentes a serem carregados](components.md) no projeto | JSON | | HTTPHandlers.json | Custom [HTTP request handlers](../WebServer/http-request-handler.md) defined for the web server | JSON | | styleSheets.css | Folhas de estilo CSS | CSS | | styleSheets_mac.css | Folhas de estilo css para Mac (de um banco de dados binário convertido) | CSS | diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Project/compiler.md b/i18n/pt/docusaurus-plugin-content-docs/current/Project/compiler.md index 50e43485075592..6e888511039519 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Project/compiler.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Project/compiler.md @@ -31,7 +31,7 @@ If errors are detected, the process is stopped and the "Compilation failed" mess  -Double-click on each error detected to open the method or class concerned directly in the 4D method editor. The line containing the error is highlighted and the type of error is displayed in the syntax area of the window. +Clique duas vezes em cada erro detectado para abrir o método ou a classe em questão diretamente no Editor de Código 4D. The line containing the error is highlighted and the type of error is displayed in the syntax area of the window. Utilice los comandos **Error anterior** / **Error siguiente** del menú **Método** para navegar de un error a otro. @@ -91,7 +91,7 @@ The "Compiler" tab of the Settings dialog box lets you set parameters related to This area groups the generic options used during the compilation process. -#### Generate symbol file +#### Gerar o arquivo de símbolo Used to generate the error file (see [error file](#symbol-file)) at the time of syntax checking. Used to generate the symbol file (see [symbol file](#symbol-file)). @@ -231,7 +231,7 @@ Estas duas listas contêm quatro colunas: - Tipo da variável. Types are set by compiler directive commands or are determined by the compiler based on the use of the variable. Se o tipo de uma variável não puder ser determinado, a coluna estará vazia. - Número de dimensões se a variável for um array. - Reference to the context in which the compiler established the type of the variable. If the variable is used in several contexts, the context mentioned is the one used by the compiler to determine its type. - - If the variable was found in a database method, the database method name is given, preceded by (M)\*. + - Se a variável foi encontrada em um método de banco de dados, o nome do método de banco de dados é dado, precedido por (M)\*. - If the variable was found in a project method, the method is identified as it has been defined in 4D, preceded by (M). - If the variable was found in a trigger, the table name is given, preceded by (TM). - If the variable was found in a form method, the form name is given, preceded by the table name and (FM). @@ -287,7 +287,7 @@ Si su proyecto no tiene errores generales, el archivo no tendrá una sección _E Um ficheiro de erros pode conter três tipos de mensagens: -- **Errores asociados a una línea específica**: estos errores se muestran en contexto -la línea en la que se encontraron y con una explicación. The compiler reports this type of error when it encounters an expression in which it sees an inconsistency related to data type or syntax. In the compiler window, double–click on each error detected in order to open the method concerned directly in the 4D Method editor, with the line containing the error highlighted. +- **Errores asociados a una línea específica**: estos errores se muestran en contexto -la línea en la que se encontraron y con una explicación. The compiler reports this type of error when it encounters an expression in which it sees an inconsistency related to data type or syntax. Na janela do compilador, clique duas vezes em cada erro detectado para abrir o método em questão diretamente no Editor de Código 4D, com a linha que contém o erro destacado. - **Errores generales**: son errores que imposibilitan la compilación del proyecto. Há dois casos em que o compilador informa um erro geral: - Não foi possível determinar o tipo de dados de uma variável processo. @@ -295,7 +295,7 @@ Um ficheiro de erros pode conter três tipos de mensagens: General errors are so named because they cannot be linked to any specific method. In the first case, the compiler could not perform a specified typing anywhere in the project. In the second, it was unable to decide whether to associate a given name with one object rather than with another. -- **Avisos**: los avisos no son errores. They do not prevent the project from being compiled, but simply point out potential code errors. Na janela do compilador, os avisos aparecem em itálico. Double-click on each warning to open the method concerned directly in the 4D Method editor, with the line containing the warning highlighted. +- **Avisos**: los avisos no son errores. They do not prevent the project from being compiled, but simply point out potential code errors. Na janela do compilador, os avisos aparecem em itálico. Clique duas vezes em cada aviso para abrir o método em questão diretamente no Editor de Código 4D, com a linha que contém o aviso destacado. ### Controlo de execução diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Project/components.md b/i18n/pt/docusaurus-plugin-content-docs/current/Project/components.md index 7ff590e3a7624a..ecc2ee272661d6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Project/components.md @@ -47,7 +47,7 @@ Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D To load a component in your 4D project, you can either: - copie os arquivos de componentes na pasta [**Components** do seu projeto] (architecture.md#components), -- or, declare the component in the **dependencies.json** file of your project; this is done automatically for local files when you [**add a dependency using the Dependency manager interface**](#adding-a-dependency). +- or, declare the component in the **dependencies.json** file of your project; this is done automatically for local files when you [**add a dependency using the Dependency manager interface**](#adding-a-github-dependency). Os componentes declarados no arquivo **dependencies.json** podem ser armazenados em locais diferentes: @@ -55,7 +55,7 @@ Os componentes declarados no arquivo **dependencies.json** podem ser armazenados - em qualquer lugar de sua máquina: o caminho do componente deve ser declarado no arquivo **environment4d.json** - em um repositório GitHub: o caminho do componente pode ser declarado no arquivo **dependencies.json** ou no arquivo **environment4d.json**, ou em ambos os arquivos. -If the same component is installed at different locations, a [priority order](#priority) is applied. +Se o mesmo componente for instalado em locais diferentes, uma [ordem de prioridade](#prioridade) é aplicada. ### dependencies.json e environment4d.json @@ -95,14 +95,16 @@ Since components can be installed in different ways, a priority order is applied ```mermaid flowchart TB - id1("1\nComponents from project's Components folder")~~~ - id2("2\nComponents listed in dependencies.json")~~~ - id2 -- environment4d.json gives path --> id4("Load component\nbased on path declared\nin environment4d.json") + id1("1| Constant | Value | Description |
|---|---|---|
| vk resize mode normal | 0 | Use normal resize mode (i.e remaining columns are affected) |
| vk resize mode split | 1 | Use split mode (i.e remaining columns are not affected) |
| Constant | Value | Description |
|---|---|---|
| vk copy paste header options all headers | 3 | Includes selected headers when data is copied; overwrites selected headers when data is pasted. |
| vk copy paste header options column headers | 2 | Includes selected column headers when data is copied; overwrites selected column headers when data is pasted. |
| vk copy paste header options no headers | 0 | Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted. |
| vk copy paste header options row headers | 1 | Includes selected row headers when data is copied; overwrites selected row headers when data is pasted. |
| Constante | Valor | Descrição |
|---|---|---|
| vk auto fill type auto | 5 | Preenche automaticamente as células. |
| vk auto fill type clear values | 4 | Clears cell values. |
| vk auto fill type copycells | 0 | Fills cells with all data objects, including values, formatting, and formulas. |
| vk auto fill type fill formatting only | 2 | Fills cells only with formatting. |
| vk auto fill type fill series | 1 | Fills cells with series. |
| vk auto fill type fill without formatting | 3 | Preenche as células com valores e sem formatação. |
| Tipo de propriedade | Descrição |
|---|---|
| String (cadeia de caracteres) | attributePath expresso usando a notação de ponto, por exemplo, "name" ou "user.address.zipCode" |
| Coleção de cadeias de caracteres | Cada cadeia de caracteres da coleção representa um nível de attributePath, por exemplo, \["name"] ou \["user", "address", "zipCode"]. Using a collection allows querying on attributes with names that are not compliant with dot notation, e.g. \["4Dv17.1","en/fr"] |
| Tipo | Descrição |
|---|---|
| String | attributePath expresso usando a notação de ponto, por exemplo, "nome" ou "usuario.endereco.cep" |
| Coleção de strings | Cada string da coleção representa um nível do attributePath, por exemplo, \["nome"] ou \["usuario","endereco","cep"]. Using a collection allows querying on attributes with names that are not compliant with dot notation, e.g. \["4Dv17.1","en/fr"] |
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostname | texto | Endereço IP ou nome do datastore remoto + ":" + número da porta |
| tls | booleano | True se a conexão segura é usada com o datastore remoto |
| idleTimeout | número | Tempo limite de inatividade da sessão (em minutos) |
| user | texto | Usuário autenticado no datastore remoto |
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostname | texto | Endereço IP ou nome do datastore remoto + ":" + número da porta |
| tls | booleano | True se a conexão segura é usada com o datastore remoto |
| idleTimeout | número | Tempo limite de inatividade da sessão (em minutos) |
| user | texto | Usuário autenticado no datastore remoto |
A standard **Save** dialog appears so you can choose the name and location of the 4D project's main folder. 3. Introduzca el nombre de su carpeta de proyecto y haga clic en **Guardar**. Este nome será utilizado: @@ -72,7 +72,7 @@ Además de las opciones sistema estándar, la caja de diálogo *Abrir* de 4D ofr ### Abrir um projeto com um ficheiro 4DLink -You can use a [`.4DLink` file](#about-4DLink-files) to launch the 4D application and open the target 4D project. Há duas formas de o fazer: +Você pode usar um [arquivo `.4DLink`](#about-4DLink-files) para iniciar a aplicação 4D e abrir o projeto alvo 4D. Há duas formas de o fazer: - haga doble clic o arrastre y suelte el archivo `.4DLink` en la aplicación 4D - vaya a **Archivo** > **Abrir los proyectos recientes** y seleccione un proyecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Menus/creating.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Menus/creating.md index 3c8e7ae559f2fe..106528bcbaab1c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Menus/creating.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Menus/creating.md @@ -57,8 +57,8 @@ Para adicionar um item de menu: 1. In the list of source menus, select the menu to which you want to add a command. Se o menu já contiver comandos, eles serão exibidos na lista central. If you want to insert the new command, select the command that you want it to appear above. Você sempre pode reorganizar o menu posteriormente, arrastando e soltando. 2. Elija **Añadir un elemento al menú "NombreDelMenú"** en el menú de opciones del editor o desde el menú contextual (clic derecho en la lista central). - OR - Click on the add  button located below the central list. + OU + Clique no botão adicionar  localizado abaixo da lista central. 4D adds a new item with the default name “Item X” where X is the number of items already created. 3. Double-click on the name of the command in order to switch it to editing mode and enter a custom name. OR Enter the custom name in the "Title" area. Pode conter até 31 caracteres. Você pode digitar o nome como "código duro" ou insira uma referência (veja abaixo). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ORDA/global-stamp.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ORDA/global-stamp.md index 62830d22d28b58..3b73ca80ab6a9c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ORDA/global-stamp.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ORDA/global-stamp.md @@ -26,7 +26,7 @@ No confunda el **sello de modificación global** con el **sello de entidad** int ## Configurando rastreamento de alterações de dados -By default, the global modification stamp is not created (the [`.getGlobalStamp()`](../API/DataStoreClass.md#getglobalstamp) function returns 0. To enable data change tracking, you need to add special fields and a table to your structure. You can use the contextual menu of the Structure Editor to create automatically all necessary elements. +Por padrão, o carimbo de modificação global não é criado (a função [`.getGlobalStamp()`](../API/DataStoreClass.md#getglobalstamp) retorna 0. To enable data change tracking, you need to add special fields and a table to your structure. You can use the contextual menu of the Structure Editor to create automatically all necessary elements. ### Requisitos de estrutura diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/architecture.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/architecture.md index 4f2cd82a0e24ec..10aea84cb84fc2 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/architecture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/architecture.md @@ -62,7 +62,7 @@ This text file can also contain configuration keys, in particular [`"tokenizedTe | tips.json | Dicas definidas | JSON | | lists.json | Listas definidas | JSON | | filters.json | Filtros definidos | JSON | -| dependencies.json | Names of [components to load](components.md) in the project | JSON | +| dependencies.json | Nomes de [componentes a serem carregados](components.md) no projeto | JSON | | styleSheets.css | Folhas de estilo CSS | CSS | | styleSheets_mac.css | Folhas de estilo css para Mac (de um banco de dados binário convertido) | CSS | | styleSheets_windows.css | Folhas de estilo css em Windows (de um banco de dados binário convertido) | CSS | diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/documentation.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/documentation.md index 2cad8bb8986d95..d0ad8aa8ad09b9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/documentation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/Project/documentation.md @@ -3,11 +3,11 @@ id: documentation title: Documentar um projecto --- -In application projects, you can document your methods as well as your forms, tables, or fields. Creating documentation is particularly appropriate for projects being developed by multiple programmers and is generally good programming practice. Documentation can contain a description of an element as well as any information necessary to understand how the element functions in the application. +Nos projetos de aplicação, você pode documentar seus métodos e suas classes, formulários, tabelas ou campos. Creating documentation is particularly appropriate for projects being developed by multiple programmers and is generally good programming practice. Documentation can contain a description of an element as well as any information necessary to understand how the element functions in the application. Os seguintes elementos do projeto aceitam documentação: -- Methods (database methods, component methods, project methods, form methods, 4D Mobile methods, triggers, and classes) +- Métodos (métodos banco de dados, métodos componentes, métodos projeto, métodos formulário, métodos 4D Mobile e triggers) - Classes - Formulários - Tabela diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/$format.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/$format.md index 79eaae3d7db551..4397613e44d076 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/$format.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/$format.md @@ -11,10 +11,10 @@ This parameter allows you to define the format to use to return data of your dat São suportados os seguintes formatos: -| Formato | Descrição | -| -------- | ------------------------------------------------------------------------------------------------- | -| `json` | Formato padrão do servidor 4D REST (usado por padrão) | -| `looker` | JSON format compliant with the [Looker Studio](https://lookerstudio.google.com/). | +| Formato | Descrição | +| -------- | ------------------------------------------------------------------------------------------------ | +| `json` | Formato padrão do servidor 4D REST (usado por padrão) | +| `looker` | Formato JSON compatível com o [Looker Studio](https://lookerstudio.google.com/). | ## Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/REST_requests.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/REST_requests.md index d741b9ebc2e9a9..dc720cdfc84e33 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/REST_requests.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/REST_requests.md @@ -22,7 +22,7 @@ Como com todas as URIs, o primeiro parâmetro é definido por um “?” e todos Os parâmetros permitem que manipule dados em dataclasses em seu projeto 4D. Además de recuperar datos mediante los métodos HTTP `GET`, también se pueden añadir, actualizar y eliminar entidades de una clase de datos utilizando los métodos HTTP `POST`. -If you want the data to be returned in an array instead of JSON, use the [`$asArray`]($asArray.md) parameter. +Se quiser que os dados sejam retornados em um array em vez de JSON, use o parâmetro [`$asArray`]($asArray.md). ## Estado e resposta REST diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/authUsers.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/authUsers.md index 556a6e1c80affb..e0e48c615af5eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/authUsers.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/authUsers.md @@ -27,7 +27,7 @@ A sequência de login do usuário é a seguinte: 1. At the first REST call (for a Qodly page call for example), a "guest" web user session is created. It has no privileges, no rights to execute requests other than [descriptive REST requests](#descriptive-rest-requests), no license consumption.\ Descriptive REST requests are always processed by the server, even if no web user session using a license is opened. In this case, they are processed through "guest" sessions. -2. You call your [`authentify()` function](#authentify) (created beforehand), in which you check the user credentials and call [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) with appropriate privileges. `authentify()` must be an exposed [datastore class function](../ORDA/ordaClasses.md#datastore-class). +2. You call your [`authentify()` function](#authentify) (created beforehand), in which you check the user credentials and call [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) with appropriate privileges. `authentify()` deve ser uma [função de datastore class](../ORDA/ordaClasses.md#datastore-class) exposta. 3. La petición `/rest/$catalog/authentify` se envía al servidor junto con las credenciales del usuario. This step only requires a basic login form that do not access data; it can be a [Qodly page](../WebServer/qodly-studio.md) (called via the `/rest/$getWebForm` request). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md index 2f13834b8cf35d..18526e31a61d79 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md @@ -7,7 +7,7 @@ Todos [los atributos, dataclasses expuestos](configuration.md#exposing-tables-an ## Pesquisas de dados -To query data directly, you can do so using the [`$filter`]($filter.md) function. Por exemplo, para encontrar a pessoa chamada "smith" poderia escrever: +Para consultar os dados diretamente, você pode fazer isso usando a função [`$filter`]($filter.md). Por exemplo, para encontrar a pessoa chamada "smith" poderia escrever: `http://127.0.0.1:8081/rest/Person/?$filter="lastName=Smith"` @@ -15,11 +15,11 @@ To query data directly, you can do so using the [`$filter`]($filter.md) function Com o REST API, pode realizar todas as manipulações de dados que quiser em 4D. -To add and modify entities, you can call [`$method=update`]($method.md#methodupdate). Sintaxe +Para adicionar e modificar entidades, você pode chamar [`$method=update`]($method.md#methodupdate). Sintaxe Besides retrieving a single entity in a dataclass using [\{dataClass\}({key})](dataClass.md#dataclasskey), you can also write a [class function](ClassFunctions.md#function-calls) that returns an entity selection (or a collection). -Before returning a selection, you can also sort it by using [`$orderby`]($orderby.md) one one or more attributes (even relation attributes). +Antes de devolver a coleção, também pode ordená-la utilizando [`$orderby`]($orderby.md) um ou vários atributos (mesmo os atributos de relação). ## Navegando dados @@ -35,7 +35,7 @@ To access the entity set, you must use `$entityset/\{entitySetID\}`, for example `/rest/People/$entityset/0AF4679A5C394746BFEB68D2162A19FF` -By default, an entity set is stored for two hours; however, you can change the timeout by passing a new value to [`$timeout`]($timeout.md). O timeout é continuamente resetado ao valor definido (seja o valor padrão ou um definido por você) a cada vez que for usado. +Por padrão, um conjunto de entidades é armazenado por duas horas; no entanto, você pode alterar o tempo limite passando um novo valor para [`$timeout`]($timeout.md). O timeout é continuamente resetado ao valor definido (seja o valor padrão ou um definido por você) a cada vez que for usado. Se quiser remover um conjunto de entidades do cache de 4D Server, você pode usar [`$method=release`]($method.md#methodrelease). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/application-server.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/application-server.md index 0efa303d84851c..9c73c94a778a5c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/application-server.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/application-server.md @@ -33,7 +33,7 @@ Si presiona el botón **Rechazar nuevas conexiones**: - O nome do projeto já não aparece na caixa de diálogo da ligação remota. - Os clientes de ambiente de trabalho que já estão ligados não são desligados e podem continuar a trabalhar normalmente. -> You can perform the same action with the [`REJECT NEW REMOTE CONNECTIONS`](https://doc.4d.com/4dv19/help/command/en/page1635.html) command. +> Você pode executar a mesma ação com o comando [`REJECT NEW REMOTE CONNECTIONS`](https://doc.4d.com/4dv19/help/command/en/page1635.html). - Si presiona el botón **Aceptar nuevas conexiones**, el servidor de aplicaciones vuelve a su estado por defecto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/real-time-monitor.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/real-time-monitor.md index a56c1b8e800526..cf6c89b0bf1874 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/real-time-monitor.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/real-time-monitor.md @@ -22,7 +22,7 @@ As informações seguintes são fornecidas para cada linha: - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). - **Detalles del proceso**: información adicional relativa a la tabla, campo, proceso o cliente, en función del tipo de operación -> Real-time monitoring page uses the [`GET ACTIVITY SNAPSHOT`](https://doc.4d.com/4dv19/help/command/en/page1277.html) command internally. Para mais informações, consultar a descrição deste comando. +> A página de monitoramento em tempo real usa internamente o comando [`GET ACTIVITY SNAPSHOT`] (https://doc.4d.com/4dv19/help/command/en/page1277.html). Para mais informações, consultar a descrição deste comando. A página está ativa e é atualizada permanentemente assim que é exibida. It should be noted that its operation can significantly slow the execution of the application. It is possible to suspend the updating of this page in one of the following ways: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/users.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/users.md index c2b36ad2446a64..8c24faae495f1b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/users.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/users.md @@ -66,4 +66,4 @@ This button can be used to directly show the processes of the user(s) selected o Este botão pode ser utilizado para forçar a desconexão do(s) usuário(s) selecionado(s). When you click on this button, a warning dialog box appears so that you can confirm or cancel this operation (hold down **Alt** key while clicking on the **Drop user** button to disconnect the selected user(s) directly without displaying the confirmation dialog box). -> You can perfom the same action for remote users with the [`DROP REMOTE USER`](https://doc.4d.com/4dv19/help/command/en/page1633.html) command. +> É possível executar a mesma ação para usuários remotos com o comando [`DROP REMOTE USER`](https://doc.4d.com/4dv19/help/command/en/page1633.html). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/advanced-programming.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/advanced-programming.md index c633ed9258993e..8edf64e58842b1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/advanced-programming.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/advanced-programming.md @@ -12,7 +12,7 @@ Dado que 4D View Pro es alimentado por la [solución de hoja de cálculo SpreadJ Since 4D View Pro is a web area, you can select a webpage element and modify its behavior using Javascript. El siguiente ejemplo oculta la [cinta](./configuring.md#ribbon) spreadJS: ```4d -//Button's object method +//Método objeto do botão var $js; $answer : Text diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-add-formula-name.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-add-formula-name.md index d6249c5a7b505a..6d655dc2a3958d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-add-formula-name.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-add-formula-name.md @@ -24,7 +24,7 @@ O comando `VP ADD FORMULA NAME` retorna um novo objeto de intervalo que faz referência a uma célula específica. -> Este comando destina-se a intervalos de uma única célula. To create a range object for multiple cells, use the [VP Cells](vp-cells.md) command. +> Este comando destina-se a intervalos de uma única célula. Para criar um objeto de intervalo para várias células, use o comando [VP Cells](vp-cells.md). Em *vpAreaName*, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-get-workbook-options.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-get-workbook-options.md index 724c6dd7c26262..14a96d0fa6aa5d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-get-workbook-options.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-get-workbook-options.md @@ -25,7 +25,7 @@ Em *vpAreaName*, passe o nome da área 4D View Pro. O objeto devolvido contém todas as opções de workbook (padrão e modificadas) no workbook. -The list of workbook options is referenced in [`VP SET WORKBOOK OPTIONS`'s description](vp-set-workbook-options.md). +A lista de opções de pasta de trabalho é referenciada na descrição de [`VP SET WORKBOOK OPTIONS`](vp-set-workbook-options.md). #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-border.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-border.md index 807c4e3036d386..4dd35273bf5673 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-border.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-border.md @@ -56,7 +56,7 @@ VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option) #### Exemplo 2 -This code demonstrates the difference between `VP SET BORDER` and setting borders with the [`VP SET CELL STYLE`](vp-set-cell-style.md) command: +Esse código demonstra a diferença entre `VP SET BORDER` e a definição de bordas com o comando [`VP SET CELL STYLE`](vp-set-cell-style.md): ```4d // Set borders using VP SET BORDER diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formula.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formula.md index 0fc67ccd6fea54..dad6e91eb3ec0f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formula.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formula.md @@ -24,9 +24,9 @@ Em *rangeObj*, passe um intervalo de células (criado, por exemplo, com [`VP Cel The *formula* parameter specifies a formula or 4D method name to be assigned to the *rangeObj*. > If the *formula* is a string, use the period `.` as numerical separator and the comma `,` as parameter separator. -> If a 4D method is used, it must be allowed with the [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md) command. +> Se um método 4D for usado, ele deverá ser permitido com o comando [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md). -The optional *formatPattern* defines a [pattern](../configuring.md#cell-format) for the *formula*. +O *formatPattern* opcional define um [padrão](../configuring.md#cell-format) para a *fórmula*. You remove the formula in *rangeObj* by replacing it with an empty string (""). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formulas.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formulas.md index de0559a29e96fc..56b36e603b5946 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formulas.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-formulas.md @@ -26,7 +26,7 @@ O parâmetro *formulasCol* é uma coleção bidimensional: - Cada subcoleção define os valores das células para a linha. Values must be text elements containing the formulas to assign to the cells. > If the formula is a string, use the period `.` as numerical separator and the comma `,` as parameter separator. -> If a 4D method is used, it must be allowed with the [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md) command. +> Se um método 4D for usado, ele deverá ser permitido com o comando [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md). You remove the formulas in *rangeObj* by replacing them with an empty string (""). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-print-info.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-print-info.md index b58864f38ce14b..ee8a2c6517733e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-print-info.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-print-info.md @@ -21,7 +21,7 @@ The `VP SET PRINT INFO` command Passe o nome da área 4D View Pro a ser impressa em *vpAreaName*. Se passar um nome que não existe, é devolvido um erro. -You can pass an object containing definitions for various printing attributes in the *printInfo* parameter. To view the full list of the available attributes, see [Print Attributes](../configuring.md#print-attributes). +You can pass an object containing definitions for various printing attributes in the *printInfo* parameter. Para ver a lista completa dos atributos disponíveis, consulte [Atributos de impressão](../configuring.md#print-attributes). In the optional *sheet* parameter, you can designate a specific spreadsheet to print (counting begins at 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-text-value.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-text-value.md index 842d3b7903d14c..3a5c11b7c5901d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-text-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-text-value.md @@ -23,7 +23,7 @@ Em *rangeObj*, passe um intervalo de células (criado, por exemplo, com [`VP Cel The *textValue* parameter specifies a text value to be assigned to the *rangeObj*. -The optional *formatPattern* defines a [pattern](../configuring.md#cell-format) for the *textValue* parameter. +O *formatPattern* opcional define um [padrão](../configuring.md#cell-format) para o parâmetro *textValue*. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-time-value.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-time-value.md index 8929bf9819aa82..4181184d501200 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-time-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-time-value.md @@ -23,7 +23,7 @@ Em *rangeObj*, passe um intervalo de células (criado, por exemplo, com [`VP Cel The *timeValue* parameter specifies a time expressed in seconds to be assigned to the *rangeObj*. -The optional *formatPattern* defines a [pattern](../configuring.md#cell-format) for the *timeValue* parameter. +O *formatPattern* opcional define um [padrão](../configuring.md#cell-format) para o parâmetro *timeValue*. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-values.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-values.md index 63b25f978549de..b50a8c78fac060 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-values.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-values.md @@ -18,7 +18,7 @@ title: VP SET VALUES The `VP SET VALUES` command assigns a collection of values starting at the specified cell range. -In *rangeObj*, pass a range for the cell (created with [`VP Cell`](vp-cell.md)) whose value you want to specify. The cell defined in the *rangeObj* is used to determine the starting point. +Em *rangeObj*, passe um intervalo para a célula (criada com [`VP Cell`](vp-cell.md)) cujo valor você deseja especificar. The cell defined in the *rangeObj* is used to determine the starting point. > - If *rangeObj* is not a cell range, only the first cell of the range is used. > - If *rangeObj* includes multiple ranges, only the first cell of the first range is used. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-workbook-options.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-workbook-options.md index 1c6f7226b99b3b..57fba92e78379e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-workbook-options.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ViewPro/commands/vp-set-workbook-options.md @@ -52,7 +52,7 @@ A tabela seguinte lista as opções de libro disponíveis: | calcOnDemand | boolean | As fórmulas só são calculadas quando são solicitadas. | | columnResizeMode | number | Modo de redimensionamento de colunas. Available values:| Constant | Value | Description |
|---|---|---|
| vk resize mode normal | 0 | Use normal resize mode (i.e remaining columns are affected) |
| vk resize mode split | 1 | Use split mode (i.e remaining columns are not affected) |
| Constant | Value | Description |
|---|---|---|
| vk copy paste header options all headers | 3 | Includes selected headers when data is copied; overwrites selected headers when data is pasted. |
| vk copy paste header options column headers | 2 | Includes selected column headers when data is copied; overwrites selected column headers when data is pasted. |
| vk copy paste header options no headers | 0 | Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted. |
| vk copy paste header options row headers | 1 | Includes selected row headers when data is copied; overwrites selected row headers when data is pasted. |
| Constante | Valor | Descrição |
|---|---|---|
| vk auto fill type auto | 5 | Preenche automaticamente as células. |
| vk auto fill type clear values | 4 | Clears cell values. |
| vk auto fill type copycells | 0 | Fills cells with all data objects, including values, formatting, and formulas. |
| vk auto fill type fill formatting only | 2 | Fills cells only with formatting. |
| vk auto fill type fill series | 1 | Fills cells with series. |
| vk auto fill type fill without formatting | 3 | Preenche as células com valores e sem formatação. |
| Tipo de propriedade | Descrição |
|---|---|
| String (cadeia de caracteres) | attributePath expresso usando a notação de ponto, por exemplo, "name" ou "user.address.zipCode" |
| Coleção de cadeias de caracteres | Cada cadeia de caracteres da coleção representa um nível de attributePath, por exemplo, \["name"] ou \["user", "address", "zipCode"]. Using a collection allows querying on attributes with names that are not compliant with dot notation, e.g. \["4Dv17.1","en/fr"] |
| Tipo | Descrição |
|---|---|
| String | attributePath expresso usando a notação de ponto, por exemplo, "nome" ou "usuario.endereco.cep" |
| Coleção de strings | Cada string da coleção representa um nível do attributePath, por exemplo, \["nome"] ou \["usuario","endereco","cep"]. Using a collection allows querying on attributes with names that are not compliant with dot notation, e.g. \["4Dv17.1","en/fr"] |
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostname | texto | Endereço IP ou nome do datastore remoto + ":" + número da porta |
| tls | booleano | True se a conexão segura é usada com o datastore remoto |
| idleTimeout | número | Tempo limite de inatividade da sessão (em minutos) |
| user | texto | Usuário autenticado no datastore remoto |
| Propriedade | Tipo | Descrição |
|---|---|---|
| hostname | texto | Endereço IP ou nome do datastore remoto + ":" + número da porta |
| tls | booleano | True se a conexão segura é usada com o datastore remoto |
| idleTimeout | número | Tempo limite de inatividade da sessão (em minutos) |
| user | texto | Usuário autenticado no datastore remoto |
A standard **Save** dialog appears so you can choose the name and location of the 4D project's main folder. 3. Introduzca el nombre de su carpeta de proyecto y haga clic en **Guardar**. Este nome será utilizado: @@ -72,7 +72,7 @@ Además de las opciones sistema estándar, la caja de diálogo *Abrir* de 4D ofr ### Abrir um projeto com um ficheiro 4DLink -You can use a [`.4DLink` file](#about-4DLink-files) to launch the 4D application and open the target 4D project. Há duas formas de o fazer: +Você pode usar um [arquivo `.4DLink`](#about-4DLink-files) para iniciar a aplicação 4D e abrir o projeto alvo 4D. Há duas formas de o fazer: - haga doble clic o arrastre y suelte el archivo `.4DLink` en la aplicación 4D - vaya a **Archivo** > **Abrir los proyectos recientes** y seleccione un proyecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Menus/creating.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Menus/creating.md index 3c8e7ae559f2fe..106528bcbaab1c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Menus/creating.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Menus/creating.md @@ -57,8 +57,8 @@ Para adicionar um item de menu: 1. In the list of source menus, select the menu to which you want to add a command. Se o menu já contiver comandos, eles serão exibidos na lista central. If you want to insert the new command, select the command that you want it to appear above. Você sempre pode reorganizar o menu posteriormente, arrastando e soltando. 2. Elija **Añadir un elemento al menú "NombreDelMenú"** en el menú de opciones del editor o desde el menú contextual (clic derecho en la lista central). - OR - Click on the add  button located below the central list. + OU + Clique no botão adicionar  localizado abaixo da lista central. 4D adds a new item with the default name “Item X” where X is the number of items already created. 3. Double-click on the name of the command in order to switch it to editing mode and enter a custom name. OR Enter the custom name in the "Title" area. Pode conter até 31 caracteres. Você pode digitar o nome como "código duro" ou insira uma referência (veja abaixo). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Notes/updates.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Notes/updates.md index ee1c8e217c967b..34575f7a0e219c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Notes/updates.md @@ -10,12 +10,12 @@ Leia [**O que há de novo no 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - As colunas e cabeçalhos da list box de tipo tempo agora suportam a opção ["blankIfNull"](../FormObjects/properties_Display.md#time-format). -- New properties in [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Novas propriedades em [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) e [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - Agora você pode [adicionar e remover componentes usando a interface do gerenciador de componentes](../Project/components.md#adding-and-removing-dependencies). - New [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) in which you declare all variables and parameters in your code using `var` and `#DECLARE`/`Function` keywords (only mode supported in new projects). [Syntax checking feature](../Project/compiler.md#check-syntax) has been enhanced accordingly. - Support of [Session singletons](../Concepts/classes.md#singleton-classes) and new [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) Class property. - New [`onHttpGet` function keyword](../ORDA/ordaClasses.md#onhttpget-keyword) to define singleton or ORDA functions that can be called through [HTTP REST GET requests](../REST/ClassFunctions.md#function-calls). -- New [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) class for the REST server to return any web contents. +- Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. - Qodly Studio: You can now [attach the Qodly debugger to 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - New Build Application keys for remote 4D applications to validate the server certificate authority [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) and/or [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - 4D Language: @@ -31,6 +31,7 @@ Leia [**O que há de novo no 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d- - Documentations for [4D Language](../commands/command-index.md) and [4D Write Pro Language](../WritePro/commands/command-index.md) are now fully available on developer.4d.com. Find out about all the new features and changes concerning these documentations in this release note. - The [`File`](../commands/file.md) command (as well as [`4D.File.new()`](../API/FileClass.md#4dfilenew)) is stricter when it comes to checking the syntax of the *path* supplied as a parameter. +- The **describe** action [permission](../ORDA/privileges.md#permission-actions) has been removed from available actions. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -44,11 +45,11 @@ Leia [**O que há de novo no 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d- - New [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) function and [`$clean`](../REST/$clean.md) REST API to get a new entity selection based upon the original entity selection but without its deleted entities. - New [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) function and [`$info/privileges`](../REST/$info.md) REST API to inspect session privileges for an easier debugging. - New [4DCEFParameters.json file](../FormObjects/webArea_overview.md#4dcefparametersjson) to customize 4D embedded web areas. -- New [HTTPAgent](../API/HTTPAgentClass.md) class and new [`agent`](../API/HTTPRequestClass.md#options-parameter) property for HTTPRequest class. +- Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. - New [`enableState()`](../API/WebFormClass.md) and [`disableState()`](../API/WebFormClass.md) functions to monitor Qodly page states from the server. - New [`$singleton` API](../REST/$singleton.md) to call exposed singleton functions from REST and new [associated privileges](../ORDA/privileges.md). - Um [novo botão de configurações](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) ajuda você a atualizar seu projeto para usar o modo REST de "login forçado" (o método de banco de dados `On REST Authentication` agora está obsoleto). -- A [new settings tab](../Project/compiler.md#warnings) helps you define warnings generation globally. +- Uma [nova guia de parametros](../Project/compiler.md#warnings) ajuda a definir a geração de avisos globalmente. - Several commands, mainly from the "4D Environment" theme, are now thread-safe ([see the full list](https://doc.4d.com/4Dv20R6/4D/Preemptive_6957385.999-2878208.en.html)), as well as some selectors of the [`SET DATABASE PARAMETER`](https://doc.4d.com/4dv20R/help/command/en/page642.html)/[`Get database parameter`](https://doc.4d.com/4dv20R/help/command/en/page643.html) commands. - New [4D-QPDF component](https://github.com/4d/4D-QPDF) that provides the `PDF Get attachments` command to extract attachments from a PDF/A3 document. - Comandos da linguagem 4D: [página Novidades](https://doc.4d.com/4Dv20R6/4D/20-R6/What-s-new.901-6957482.en.html) em doc.4d.com. @@ -74,7 +75,7 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- - Suporte à [inicializando uma propriedade de classe em sua linha de declaração](../Concepts/classes.md/#initializing-the-property-in-the-declaration-line). - Novo modo [forçar login para solicitações REST](../REST/authUsers.md#force-login-mode) com um suporte específico [no Qodly Studio para 4D](../WebServer/qodly-studio.md#force-login). - Nuevo parámetro REST [$format](../REST/$format.md). -- [`Session`](../commands/session.md) object is now available in remote user sessions and stored procedures session. +- O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. - Comandos da linguagem 4D: [página Novidades](https://doc.4d.com/4Dv20R5/4D/20-R5/What-s-new.901-6817247.en.html) em doc.4d.com. - 4D Write Pro: [What's new page](https://doc.4d.com/4Dv20R5/4D/20-R5/What-s-new.901-6851780.en.html) on doc.4d.com. - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. @@ -82,7 +83,7 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- #### Mudanças de comportamento - Os plug-ins *4D Internet Commands* e *4D for OCI* não estão mais incluídos nos instaladores do 4D. Para obter esses plug-ins, você precisa se conectar ao [**Portal de descarrega de produtos 4D**](https://product-download.4d.com/). -- Changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) are now saved in a separate file named `catalog_editor.json` stored in the project's [`Sources`](../Project/architecture.md#sources) folder. +- Changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) agora são salvas em um arquivo separado chamado `catalog_editor.json` armazenado na pasta [`Sources`](../Project/architecture.md#sources) do projeto. ## 4D 20 R4 @@ -90,15 +91,15 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d #### Destaques -- Support of [`ECDSA` encryption format](../Admin/tls.md#encryption) for TLS certificates. +- Suporte do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. - Client/server and SQL server TLS connections are now [configured dynamically](../Admin/tls.md#enabling-tls-with-the-other-servers) (no certificate files are required). - Direct HTML format for [structure definition exports](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - New [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) that enhances code control during code typing, syntax checking, and compilation steps to prevent execution errors. - Method parameters declared in `#DECLARE` prototypes are [no longer necessary in "Compiler_" methods](../Concepts/parameters.md#compilation). - Suporte de [formatos personalizados de data e hora](../Project/date-time-formats.md) -- New [`Try(expression)` keyword](../Concepts/error-handling.md#tryexpression) to handle simple error cases. +- Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. - Novo comando [`HTTP Parse message`](../API/HTTPRequestClass.md#http-parse-message). -- New [Non-blocking printing](../settings/compatibility.md) compatibility option. +- Nova opção de compatibilidade [Impressão sem bloqueio](../settings/compatibility.md). - Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. - Comandos da linguagem 4D: [Novidades de página](https://doc.4d.com/4Dv20R4/4D/20-R4/What-s-new.901-6655756.en.html) em doc.4d.com. - 4D Write Pro: [Página Novidades] (https://doc.4d.com/4Dv20R4/4D/20-R4/What-s-new.901-6683440.en.html) em doc.4d.com. @@ -109,7 +110,7 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d - Usando uma sintaxe legada para declarar parâmetros (por exemplo, `C_TEXT($1)` ou `var $1 : Text`) está agora obsoleto e gera avisos na digitação de código, verificação de sintaxe e etapas de compilação. - La coherencia de las selecciones ahora se mantiene después de que se hayan eliminado algunos registros y se hayan creado otros (ver [esta entrada de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). - In the updated [OpenSSL library](#library-table), the default SSL/TLS security level has been changed from 1 to 2. Chaves RSA, DSA e DH de 1024 bits ou mais e menos de 2048 bits, assim como chaves ECC de 160 bits ou mais e menos de 224 bits, agora não são mais permitidas. Por padrão, a compressão TLS já estava desativada nas versões anteriores do OpenSSL. No nível de segurança 2, ele não pode ser habilitado. -- In order to allow password verification when the [4D user directory uses the bcrypt algorithm](https://blog.4d.com/bcrypt-support-for-passwords/), the "password" value in the *connectionInfo* parameter of the [`Open datastore`](../commands/open-datastore.md) command is now sent in clear form by default. Make sure your "On REST authentication" database method can handle passwords in clear form (third parameter is then **False**) and that `Open datastore` encrypts your connection by passing the "tls" option to **True** in *connectionInfo*. In specific cases, a new "passwordAlgorithm" option can also be used for compatibility (see [`Open datastore`](../commands/open-datastore.md) command). +- Make sure your "On REST authentication" database method can handle passwords in clear form (third parameter is then **False**) and that `Open datastore` encrypts your connection by passing the "tls" option to **True** in *connectionInfo*. In order to allow password verification when the [4D user directory uses the bcrypt algorithm](https://blog.4d.com/bcrypt-support-for-passwords/), the "password" value in the *connectionInfo* parameter of the [`Open datastore`](../commands/open-datastore.md) command is now sent in clear form by default. In specific cases, a new "passwordAlgorithm" option can also be used for compatibility (see [`Open datastore`](../commands/open-datastore.md) command). ## 4D 20 R3 @@ -148,11 +149,11 @@ Se suas aplicações 4D utilizam conexões TLS, é recomendado que você faça a #### Destaques - New [WebSocket class](../API/WebSocketClass.md) to create and manage client WebSocket connections from 4D. -- New QUIC network layer [interface setting](../settings/client-server.md#network-layer). +- Nova [configuração de interface] (../settings/client-server.md#network-layer) para a camada de rede QUIC. - 4D View Pro: soporte del formato de archivo **.sjs** para [la importación](../ViewPro/commands/vp-import-document) y la [exportación](../ViewPro/commands/vp-export-document) de documentos. - Comandos da linguagem 4D: [Novidades de página](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.en.html) em doc.4d.com. - 4D Write Pro: [Página Novidades] (https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6390313.en.html) em doc.4d.com. -- 4D Write Pro Interface: New [Table Wizard](../WritePro/writeprointerface.md). +- Interface 4D Write Pro: novo [Table Wizard](../WritePro/writeprointerface.md). - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos os bugs corrigidos em 4D 20 R2. #### Mudanças de comportamento diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/entities.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/entities.md index b2ab5829b8388f..493be9a98c7e86 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/entities.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/entities.md @@ -90,7 +90,7 @@ Puede manejar las entidades como cualquier otro objeto en 4D y pasar sus referen :::info -Com as entidades, não há o conceito de "registro atual" como na linguagem 4D. Pode utilizar tantas entidades quantas as necessárias, em simultâneo. There is also no automatic lock on an entity (see [Entity locking](#entity-locking)). When an entity is loaded, it uses the [lazy loading](glossary.md#lazy-loading) mechanism, which means that only the needed information is loaded. No entanto, no cliente/servidor, a entidade pode ser carregada automaticamente de forma direta, se necessário. +Com as entidades, não há o conceito de "registro atual" como na linguagem 4D. Pode utilizar tantas entidades quantas as necessárias, em simultâneo. Não há também bloqueio automático em uma entidade (veja [bloqueio de Entity](#entity-locking)). When an entity is loaded, it uses the [lazy loading](glossary.md#lazy-loading) mechanism, which means that only the needed information is loaded. No entanto, no cliente/servidor, a entidade pode ser carregada automaticamente de forma direta, se necessário. ::: @@ -238,7 +238,7 @@ Você pode atribuir ou modificar o valor de um "1" atributo da entidade relacion Puede crear un objeto de tipo [entity selection](dsMapping.md#entity-selection) de la siguiente manera: - Lance una búsqueda en las entidades [en una dataclass](API/DataClassClass.md#query) o en una [selección de entidades existente](API/EntitySelectionClass.md#query); -- Using the [`.all()`](API/DataClassClass.md#all) dataclass function to select all the entities in a dataclass; +- Usando a função dataclass [`.all()`](API/DataClassClassClass.md#all), para selecionar todas as entidades em um dataclass; - Using the [`Create entity selection`](../commands/create-entity-selection.md) command or the [`.newSelection()`](API/DataClassClass.md#newselection) dataclass function to create a blank entity selection; - Usando a [`.copy()`](API/EntitySelectionClass.md#copy) função para duplicar uma seleção de entidade existente; - Using one of the various functions from the [Entity selection class](API/EntitySelectionClass.md) that returns a new entity selection, such as [`.or()`](API/EntitySelectionClass.md#or); @@ -270,12 +270,12 @@ Una entity selection **compartible** tiene las siguientes características: - it can be stored in several shared objects or collections, or in a shared object or collection which already belongs to a group; - não permite a adição de novas entidades. A tentativa de adicionar uma entidade a uma seleção de entidade compartilhável acionará um erro (1637 - Esta seleção de entidade não pode ser alterada). To add an entity to a shareable entity selection, you must first transform it into a non-shareable entity selection using the [`.copy()`](API/EntitySelectionClass.md#copy) function, before calling [`.add()`](API/EntitySelectionClass.md#add). -> Most entity selection functions (such as [`.slice()`](API/EntitySelectionClass.md#slice), [`.and()`](API/EntitySelectionClass.md#and)...) support shareable entity selections since they do not need to alter the original entity selection (they return a new one). +> A maioria das funções de seleção de entidades (como [`.slice()`](API/EntitySelectionClass.md#slice), [`.and()`](API/EntitySelectionClass.md#and)...) support shareable entity selections since they do not need to alter the original entity selection (they return a new one). Una entity selection **modificable** tiene las siguientes características: - não pode ser compartilhado entre processos, nem armazenado em um objeto ou coleção compartilhada. A tentativa de armazenar uma seleção de entidade não compartilhável em um objeto ou coleção compartilhada acionará um erro (-10721 - Tipo de valor não suportado em um objeto compartilhado ou coleção compartilhada); -- it accepts the addition of new entities, i.e. it is supports the [`.add()`](API/EntitySelectionClass.md#add) function. +- ele aceita a adição de novas entidades, ou seja, suporta a função [`.add()`](API/EntitySelectionClass.md#add). #### Como é que são definidos? @@ -334,7 +334,7 @@ $comp2:=$lowSal.employer //$comp2 is alterable because $lowSal is alterable :::note Entity selections devolvidas pelo servidor -In client/server architecture, entity selections returned from the server are always shareable on the client, even if [`copy()`](API/EntitySelectionClass.md#copy) was called on the server. To make such an entity selection alterable on the client, you need to execute [`copy()`](API/EntitySelectionClass.md#copy) on the client side. Exemplo: +In client/server architecture, entity selections returned from the server are always shareable on the client, even if [`copy()`](API/EntitySelectionClass.md#copy) was called on the server. Para tornar essa seleção de entidade alterável no cliente, você precisa executar [`copy()`](API/EntitySelectionClass.md#copy) no lado do cliente. Exemplo: ```4d //a function is always executed on the server @@ -530,7 +530,7 @@ Los filtros no se aplican a las selecciones heredadas de registros manejadas a t | [entity.attributeName](../API/EntityClass.md#attributename) | Filtro aplicado si *attributeName* corresponde a entidades relacionadas de una clase de datos filtrada (incluyendo alias o atributo calculado) | | [Create entity selection](../commands/create-entity-selection.md) | | -Other ORDA functions accessing data do not directly trigger the filter, but they nevertheless benefit from it. For example, the [`entity.next()`](../API/EntityClass.md#next) function will return the next entity in the already-filtered entity selection. On the other hand, if the entity selection is not filtered, [`entity.next()`](../API/EntityClass.md#next) will work on non-filtered entities. +Other ORDA functions accessing data do not directly trigger the filter, but they nevertheless benefit from it. Por exemplo, a função [`entity.next()`](../API/EntityClass.md#next) retornará a próxima entidade na seleção de entidade já filtrada. Por outro lado, se a seleção de entidade não estiver filtrada, [`entity.next()`](../API/EntityClass.md#next) funcionará em entidades não filtradas. :::note diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/global-stamp.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/global-stamp.md index 62830d22d28b58..3b73ca80ab6a9c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/global-stamp.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/global-stamp.md @@ -26,7 +26,7 @@ No confunda el **sello de modificación global** con el **sello de entidad** int ## Configurando rastreamento de alterações de dados -By default, the global modification stamp is not created (the [`.getGlobalStamp()`](../API/DataStoreClass.md#getglobalstamp) function returns 0. To enable data change tracking, you need to add special fields and a table to your structure. You can use the contextual menu of the Structure Editor to create automatically all necessary elements. +Por padrão, o carimbo de modificação global não é criado (a função [`.getGlobalStamp()`](../API/DataStoreClass.md#getglobalstamp) retorna 0. To enable data change tracking, you need to add special fields and a table to your structure. You can use the contextual menu of the Structure Editor to create automatically all necessary elements. ### Requisitos de estrutura diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/glossary.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/glossary.md index ff8bb44ac3feb8..68444d97a4724d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/glossary.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/glossary.md @@ -9,7 +9,7 @@ title: Glossary ## Ação -Todas las acciones que pueden realizarse en un [recurso](#resource). As ações disponíveis são: criar, ler, atualizar, largar, executar, promover e descrever. +Todas las acciones que pueden realizarse en un [recurso](#resource). Available actions are: create, read, update, drop, execute, and promote. ## Atributo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/ordaClasses.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/ordaClasses.md index 15f90d3168459f..47758e568e8961 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/ordaClasses.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/ordaClasses.md @@ -847,7 +847,7 @@ As this type of call is an easy offered action, the developer must ensure no sen ### params -A function with `onHttpGet` keyword accepts [parameters](../Concepts/parameters.md). +Uma função com a palavra-chave `onHttpGet` aceita [parâmetros](../Concepts/parameters.md). In the HTTP GET request, parameters must be passed directly in the URL and declared using the `$params` keyword (they must be enclosed in a collection). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md index 0ddb9e1f18e608..767e6ea4ef605b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/privileges.md @@ -49,15 +49,14 @@ Permissões controlam o acesso a objetos ou funções de armazenamento de dados. As ações disponíveis estão relacionadas com o recurso alvo. -| Acções | armazém de dados | dataclass | atributo | função de modelo de dados ou função singleton | -| ------------ | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **create** | Criar entidade em qualquer classe de dados | Criar entidade nesta classe de dados | Create an entity with a value different from default value allowed for this attribute (ignored for alias attributes). | n/a | -| **read** | Ler atributos em qualquer dataclass | Ler atributos nesta classe de dados | Leia o conteúdo desse atributo | n/a | -| **update** | Atualizar atributos em qualquer classe de dados. | Atualiza os atributos nesta classe de dados. | Atualiza o conteúdo deste atributo (ignorado para atributos alias). | n/a | -| **drop** | Eliminar dados em qualquer classe de dados. | Eliminar dados nesta classe de dados. | Delete a not null value for this attribute (except for alias and computed attribute). | n/a | -| **execute** | Execute any function on the project (datastore, dataclass, entity selection, entity) | Executa qualquer função na classe de dados. Dataclass functions, entity functions, and entity selection functions are handled as dataclass functions | n/a | Executar esta função | -| **describe** | Todas as classes de dados estão disponíveis na /rest/$catalog API | Esta dataclass está disponível na API /rest/$catalog | Esse atributo está disponível na API /rest/$catalog. | Esta função de dataclass está disponível na API /rest/$catalog (não disponível com singletons) | -| **promote** | n/a | n/a | n/a | Associa um determinado privilégio durante a execução da função. The privilege is temporary added to the session and removed at the end of the function execution. By security, only the process executing the function is added the privilege, not the whole session. | +| Acções | armazém de dados | dataclass | atributo | função de modelo de dados ou função singleton | +| ----------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **create** | Criar entidade em qualquer classe de dados | Criar entidade nesta classe de dados | Create an entity with a value different from default value allowed for this attribute (ignored for alias attributes). | n/a | +| **read** | Ler atributos em qualquer dataclass | Ler atributos nesta classe de dados | Leia o conteúdo desse atributo | n/a | +| **update** | Atualizar atributos em qualquer classe de dados. | Atualiza os atributos nesta classe de dados. | Atualiza o conteúdo deste atributo (ignorado para atributos alias). | n/a | +| **drop** | Eliminar dados em qualquer classe de dados. | Eliminar dados nesta classe de dados. | Delete a not null value for this attribute (except for alias and computed attribute). | n/a | +| **execute** | Execute any function on the project (datastore, dataclass, entity selection, entity) | Executa qualquer função na classe de dados. Dataclass functions, entity functions, and entity selection functions are handled as dataclass functions | n/a | Executar esta função | +| **promote** | n/a | n/a | n/a | Associa um determinado privilégio durante a execução da função. The privilege is temporary added to the session and removed at the end of the function execution. By security, only the process executing the function is added the privilege, not the whole session. | **Notas:** @@ -67,10 +66,7 @@ As ações disponíveis estão relacionadas com o recurso alvo. - Valores padrão: na implementação atual, apenas *Null* está disponível como valor padrão. - No REST [modo de login](../REST/authUsers.md/#force-login-mode), a [função `authentify()`](../REST/authUsers.md#function-authentify) é sempre executável por usuários convidados, independentemente da configuração das permissões. -A definição das permissões deve ser coerente, nomeadamente: - -- Permissões de **atualização** e **drop** também precisam da permissão **read** (mas **create** não precisa dela) -- Para funções do modelo de dados, permissão de **promoção** também precisa de permissão **descrever**. +Setting permissions requires to be consistent, in particular **update** and **drop** permissions also need **read** permission (but **create** does not need it). ## Privilégios e roles @@ -139,7 +135,6 @@ O arquivo padrão tem o seguinte conteúdo: "create": ["none"], "update": ["none"], "drop": ["none"], - "describe": ["none"], "execute": ["none"], "promote": ["none"] } @@ -175,26 +170,25 @@ No Qodly Studio para 4D, o modo pode ser definido usando a opção [**Forçar lo A sintaxe do arquivo `roles.json` é a seguinte: -| Nome da propriedade | | | Tipo | Obrigatório | Descrição | -| ------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | -| privileges | | | Coleção de objetos de 'privilégio' | X | Lista de privilégios definidos | -| | \[].privilege | | Text | | Nome do privilégio | -| | \[].includes | | Coleção de strings | | Lista de nomes de privilégios incluídos | -| roles | | | Coleção de objetos `papel` | | Lista de roles definidos | -| | \[].role | | Text | | Nome da role | -| | \[].privileges | | Coleção de strings | | Lista de nomes de privilégios incluídos | -| permissions | | | Object | X | Lista de acções permitidas | -| | allowed | | Colección de objetos `permission` | | Lista de permissões permitidas | -| | | \[].applyTo | Text | X | Targeted [resource](#resources) name | -| | | \[].type | Text | X | [Resource](#resources) type: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | -| | | \[].read | Coleção de strings | | Lista de privilégios | -| | | \[].create | Coleção de strings | | Lista de privilégios | -| | | \[].update | Coleção de strings | | Lista de privilégios | -| | | \[].drop | Coleção de strings | | Lista de privilégios | -| | | \[].describe | Coleção de strings | | Lista de privilégios | -| | | \[].execute | Coleção de strings | | Lista de privilégios | -| | | \[].promote | Coleção de strings | | Lista de privilégios | -| forceLogin | | | Parâmetros | | True para habilitar el [modo "forceLogin"](../REST/authUsers.md#force-login-mode) | +| Nome da propriedade | | | Tipo | Obrigatório | Descrição | +| ------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | +| privileges | | | Coleção de objetos de 'privilégio' | X | Lista de privilégios definidos | +| | \[].privilege | | Text | | Nome do privilégio | +| | \[].includes | | Coleção de strings | | Lista de nomes de privilégios incluídos | +| roles | | | Coleção de objetos `papel` | | Lista de roles definidos | +| | \[].role | | Text | | Nome da role | +| | \[].privileges | | Coleção de strings | | Lista de nomes de privilégios incluídos | +| permissions | | | Object | X | Lista de acções permitidas | +| | allowed | | Colección de objetos `permission` | | Lista de permissões permitidas | +| | | \[].applyTo | Text | X | Targeted [resource](#resources) name | +| | | \[].type | Text | X | [Resource](#resources) type: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | +| | | \[].read | Coleção de strings | | Lista de privilégios | +| | | \[].create | Coleção de strings | | Lista de privilégios | +| | | \[].update | Coleção de strings | | Lista de privilégios | +| | | \[].drop | Coleção de strings | | Lista de privilégios | +| | | \[].execute | Coleção de strings | | Lista de privilégios | +| | | \[].promote | Coleção de strings | | Lista de privilégios | +| forceLogin | | | Parâmetros | | True para habilitar el [modo "forceLogin"](../REST/authUsers.md#force-login-mode) | :::caution Lembrete @@ -254,9 +248,6 @@ A boa prática é manter todo o acesso aos dados bloqueado por padrão graças a "execute": [ "none" ], - "describe": [ - "none" - ], "promote": [ "none" ] diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md index 3133e7eb2c95e0..ddd35089e24092 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ORDA/remoteDatastores.md @@ -49,7 +49,7 @@ Os recursos do ORDA relacionados ao bloqueio de entidades e à transação são - Si un proceso bloquea una entidad de un datastores remoto, la entidad se bloquea para todos los otros procesos, incluso cuando estos procesos comparten la misma sesión (ver [Bloqueo de entidades](entities.md#entity-locking)). Se várias entidades que apontam para um mesmo registro tiverem sido bloqueadas em um processo, todas elas deverão ser desbloqueadas no processo para remover o bloqueio. Se um bloqueio tiver sido colocado em uma entidade, o bloqueio será removido quando não houver mais referência a essa entidade na memória. - Las transacciones pueden iniciarse, validarse o cancelarse por separado en cada almacén de datos remoto mediante las funciones `dataStore.startTransaction()`, `dataStore.cancelTransaction()` y `dataStore.validateTransaction()`. Não têm impacto noutros datastores. -- Los comandos clásicos del lenguaje 4D (`START TRANSACTION`, `VALIDATE TRANSACTION`, `CANCEL TRANSACTION`) sólo se aplican al datastore principal (devuelto por `ds`). +- Classic 4D language commands ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) only apply to the main datastore (returned by `ds`). Se uma entidade de um datastore remoto é segurada por uma transação em um processo, outros processos não podem atualizá-lo, mesmo que esses processos compartilhem a mesma sessão. - Os bloqueios nas entidades são removidos e as transações são anuladas: - quando o processo é eliminado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/architecture.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/architecture.md index 4f2cd82a0e24ec..10aea84cb84fc2 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/architecture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/architecture.md @@ -62,7 +62,7 @@ This text file can also contain configuration keys, in particular [`"tokenizedTe | tips.json | Dicas definidas | JSON | | lists.json | Listas definidas | JSON | | filters.json | Filtros definidos | JSON | -| dependencies.json | Names of [components to load](components.md) in the project | JSON | +| dependencies.json | Nomes de [componentes a serem carregados](components.md) no projeto | JSON | | styleSheets.css | Folhas de estilo CSS | CSS | | styleSheets_mac.css | Folhas de estilo css para Mac (de um banco de dados binário convertido) | CSS | | styleSheets_windows.css | Folhas de estilo css em Windows (de um banco de dados binário convertido) | CSS | diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/compiler.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/compiler.md index fa821b48d4ffaf..c3501b77820ba6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/compiler.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/compiler.md @@ -31,7 +31,7 @@ If errors are detected, the process is stopped and the "Compilation failed" mess  -Double-click on each error detected to open the method or class concerned directly in the 4D method editor. The line containing the error is highlighted and the type of error is displayed in the syntax area of the window. +Clique duas vezes em cada erro detectado para abrir o método ou a classe em questão diretamente no Editor de Código 4D. The line containing the error is highlighted and the type of error is displayed in the syntax area of the window. Utilice los comandos **Error anterior** / **Error siguiente** del menú **Método** para navegar de un error a otro. @@ -91,7 +91,7 @@ The "Compiler" tab of the Settings dialog box lets you set parameters related to This area groups the generic options used during the compilation process. -#### Generate symbol file +#### Gerar o arquivo de símbolo Used to generate the error file (see [error file](#symbol-file)) at the time of syntax checking. Used to generate the symbol file (see [symbol file](#symbol-file)). @@ -231,7 +231,7 @@ Estas duas listas contêm quatro colunas: - Tipo da variável. Types are set by compiler directive commands or are determined by the compiler based on the use of the variable. Se o tipo de uma variável não puder ser determinado, a coluna estará vazia. - Número de dimensões se a variável for um array. - Reference to the context in which the compiler established the type of the variable. If the variable is used in several contexts, the context mentioned is the one used by the compiler to determine its type. - - If the variable was found in a database method, the database method name is given, preceded by (M)\*. + - Se a variável foi encontrada em um método de banco de dados, o nome do método de banco de dados é dado, precedido por (M)\*. - If the variable was found in a project method, the method is identified as it has been defined in 4D, preceded by (M). - If the variable was found in a trigger, the table name is given, preceded by (TM). - If the variable was found in a form method, the form name is given, preceded by the table name and (FM). @@ -287,7 +287,7 @@ Si su proyecto no tiene errores generales, el archivo no tendrá una sección *E Um ficheiro de erros pode conter três tipos de mensagens: -- **Errores asociados a una línea específica**: estos errores se muestran en contexto -la línea en la que se encontraron y con una explicación. The compiler reports this type of error when it encounters an expression in which it sees an inconsistency related to data type or syntax. In the compiler window, double–click on each error detected in order to open the method concerned directly in the 4D Method editor, with the line containing the error highlighted. +- **Errores asociados a una línea específica**: estos errores se muestran en contexto -la línea en la que se encontraron y con una explicación. The compiler reports this type of error when it encounters an expression in which it sees an inconsistency related to data type or syntax. Na janela do compilador, clique duas vezes em cada erro detectado para abrir o método em questão diretamente no Editor de Código 4D, com a linha que contém o erro destacado. - **Errores generales**: son errores que imposibilitan la compilación del proyecto. Há dois casos em que o compilador informa um erro geral: - Não foi possível determinar o tipo de dados de uma variável processo. @@ -295,7 +295,7 @@ Um ficheiro de erros pode conter três tipos de mensagens: General errors are so named because they cannot be linked to any specific method. In the first case, the compiler could not perform a specified typing anywhere in the project. In the second, it was unable to decide whether to associate a given name with one object rather than with another. -- **Avisos**: los avisos no son errores. They do not prevent the project from being compiled, but simply point out potential code errors. Na janela do compilador, os avisos aparecem em itálico. Double-click on each warning to open the method concerned directly in the 4D Method editor, with the line containing the warning highlighted. +- **Avisos**: los avisos no son errores. They do not prevent the project from being compiled, but simply point out potential code errors. Na janela do compilador, os avisos aparecem em itálico. Clique duas vezes em cada aviso para abrir o método em questão diretamente no Editor de Código 4D, com a linha que contém o aviso destacado. ### Controlo de execução diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/components.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/components.md index 3b097d7370633a..e82d9f4d1cc49c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/components.md @@ -42,7 +42,7 @@ Os componentes declarados no arquivo **dependencies.json** podem ser armazenados - em qualquer lugar de sua máquina: o caminho do componente deve ser declarado no arquivo **environment4d.json** - em um repositório GitHub: o caminho do componente pode ser declarado no arquivo **dependencies.json** ou no arquivo **environment4d.json**, ou em ambos os arquivos. -If the same component is installed at different locations, a [priority order](#priority) is applied. +Se o mesmo componente for instalado em locais diferentes, uma [ordem de prioridade](#prioridade) é aplicada. ### dependencies.json e environment4d.json @@ -150,7 +150,7 @@ If a component path declared in the **environment4d.json** file is not found whe #### Caminhos relativos versus caminhos absolutos -Paths are expressed in POSIX syntax as described in [this paragraph](../Concepts/paths#posix-syntax). +Os caminhos são expressos na sintaxe POSIX, conforme descrito em [este parágrafo](../Concepts/paths#posix-syntax). Os caminhos relativos são relativos ao arquivo [`environment4d.json`](#environment4djson). Absolute paths are linked to the user's machine. @@ -158,9 +158,9 @@ Using relative paths is **recommended** in most cases, since they provide flexib Absolute paths should only be used for components that are specific to one machine and one user. -### Components stored on GitHub +### Componentes armazenados no GitHub -4D components available as GitHub releases can be referenced and automatically loaded in your 4D projects. +Componentes 4D disponíveis como lançamentos do GitHub podem ser referenciados e carregados automaticamente nos seus projetos 4D. :::note @@ -224,7 +224,7 @@ Ao criar uma versão no GitHub, você especifica uma **etiqueta** e uma **versã } ``` -- Uma versão também é identificada por uma **versão**. The versioning system used is based on the *Semantic Versioning* concept, which is the most commonly used. Each version number is identified as follows: `majorNumber.minorNumber.pathNumber`. In the same way as for tags, you can indicate the version of the component you wish to use in your project, as in this example: +- Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de *Semantic Versioning*, que é o mais usado. Each version number is identified as follows: `majorNumber.minorNumber.pathNumber`. In the same way as for tags, you can indicate the version of the component you wish to use in your project, as in this example: ```json { @@ -237,7 +237,7 @@ Ao criar uma versão no GitHub, você especifica uma **etiqueta** e uma **versã } ``` -The version is used to define which versions can be used. É usada uma [versão semântica padrão] (https://regex101.com/r/Ly7O1x/3/). A range is defined by two semantic versions, a min and a max, with operators '\< | > | >= | <= | ='. O `*` pode ser usado como um espaço reservado para todas as versões. ~ and ^ prefixes define versions starting at a number, and up to respectively the next major and minor version. +A versão é usada para definir quais versões podem ser usadas. É usada uma [versão semântica padrão] (https://regex101.com/r/Ly7O1x/3/). A range is defined by two semantic versions, a min and a max, with operators '\< | > | >= | <= | ='. O `*` pode ser usado como um espaço reservado para todas as versões. ~ and ^ prefixes define versions starting at a number, and up to respectively the next major and minor version. Eis alguns exemplos: @@ -361,7 +361,7 @@ If the component is stored on a [private GitHub repository](#private-repositorie ::: -You can then define the [tag or version](#tags-and-versions) option for the dependency: +Em seguida, você pode definir a opção [tag ou versão](#tags-and-versions) para a dependência:  diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/documentation.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/documentation.md index 2cad8bb8986d95..d0ad8aa8ad09b9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/documentation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/Project/documentation.md @@ -3,11 +3,11 @@ id: documentation title: Documentar um projecto --- -In application projects, you can document your methods as well as your forms, tables, or fields. Creating documentation is particularly appropriate for projects being developed by multiple programmers and is generally good programming practice. Documentation can contain a description of an element as well as any information necessary to understand how the element functions in the application. +Nos projetos de aplicação, você pode documentar seus métodos e suas classes, formulários, tabelas ou campos. Creating documentation is particularly appropriate for projects being developed by multiple programmers and is generally good programming practice. Documentation can contain a description of an element as well as any information necessary to understand how the element functions in the application. Os seguintes elementos do projeto aceitam documentação: -- Methods (database methods, component methods, project methods, form methods, 4D Mobile methods, triggers, and classes) +- Métodos (métodos banco de dados, métodos componentes, métodos projeto, métodos formulário, métodos 4D Mobile e triggers) - Classes - Formulários - Tabela diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/$format.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/$format.md index 79eaae3d7db551..4397613e44d076 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/$format.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/$format.md @@ -11,10 +11,10 @@ This parameter allows you to define the format to use to return data of your dat São suportados os seguintes formatos: -| Formato | Descrição | -| -------- | ------------------------------------------------------------------------------------------------- | -| `json` | Formato padrão do servidor 4D REST (usado por padrão) | -| `looker` | JSON format compliant with the [Looker Studio](https://lookerstudio.google.com/). | +| Formato | Descrição | +| -------- | ------------------------------------------------------------------------------------------------ | +| `json` | Formato padrão do servidor 4D REST (usado por padrão) | +| `looker` | Formato JSON compatível com o [Looker Studio](https://lookerstudio.google.com/). | ## Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/ClassFunctions.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/ClassFunctions.md index c55b2216bb36fe..e1959a673aca92 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/ClassFunctions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/ClassFunctions.md @@ -628,7 +628,7 @@ $ageAverage:=$students.getAgeAverage() ### Returning a document -You want to propose a link to download the user manual for a selected product with several formats available. You write a `getUserManual()` function of the Products dataclass. You return an object of the [`OutgoingMessage` class](../API/OutgoingMessageClass.md). +You want to propose a link to download the user manual for a selected product with several formats available. You write a `getUserManual()` function of the Products dataclass. Você retorna um objeto da [classe `OutgoingMessage`](../API/OutgoingMessageClass.md). ```4d // Product dataclass diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/REST_requests.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/REST_requests.md index d741b9ebc2e9a9..dc720cdfc84e33 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/REST_requests.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/REST_requests.md @@ -22,7 +22,7 @@ Como com todas as URIs, o primeiro parâmetro é definido por um “?” e todos Os parâmetros permitem que manipule dados em dataclasses em seu projeto 4D. Además de recuperar datos mediante los métodos HTTP `GET`, también se pueden añadir, actualizar y eliminar entidades de una clase de datos utilizando los métodos HTTP `POST`. -If you want the data to be returned in an array instead of JSON, use the [`$asArray`]($asArray.md) parameter. +Se quiser que os dados sejam retornados em um array em vez de JSON, use o parâmetro [`$asArray`]($asArray.md). ## Estado e resposta REST diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/authUsers.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/authUsers.md index 556a6e1c80affb..e0e48c615af5eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/authUsers.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/authUsers.md @@ -27,7 +27,7 @@ A sequência de login do usuário é a seguinte: 1. At the first REST call (for a Qodly page call for example), a "guest" web user session is created. It has no privileges, no rights to execute requests other than [descriptive REST requests](#descriptive-rest-requests), no license consumption.\ Descriptive REST requests are always processed by the server, even if no web user session using a license is opened. In this case, they are processed through "guest" sessions. -2. You call your [`authentify()` function](#authentify) (created beforehand), in which you check the user credentials and call [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) with appropriate privileges. `authentify()` must be an exposed [datastore class function](../ORDA/ordaClasses.md#datastore-class). +2. You call your [`authentify()` function](#authentify) (created beforehand), in which you check the user credentials and call [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) with appropriate privileges. `authentify()` deve ser uma [função de datastore class](../ORDA/ordaClasses.md#datastore-class) exposta. 3. La petición `/rest/$catalog/authentify` se envía al servidor junto con las credenciales del usuario. This step only requires a basic login form that do not access data; it can be a [Qodly page](../WebServer/qodly-studio.md) (called via the `/rest/$getWebForm` request). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/manData.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/manData.md index 2f13834b8cf35d..18526e31a61d79 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/manData.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/REST/manData.md @@ -7,7 +7,7 @@ Todos [los atributos, dataclasses expuestos](configuration.md#exposing-tables-an ## Pesquisas de dados -To query data directly, you can do so using the [`$filter`]($filter.md) function. Por exemplo, para encontrar a pessoa chamada "smith" poderia escrever: +Para consultar os dados diretamente, você pode fazer isso usando a função [`$filter`]($filter.md). Por exemplo, para encontrar a pessoa chamada "smith" poderia escrever: `http://127.0.0.1:8081/rest/Person/?$filter="lastName=Smith"` @@ -15,11 +15,11 @@ To query data directly, you can do so using the [`$filter`]($filter.md) function Com o REST API, pode realizar todas as manipulações de dados que quiser em 4D. -To add and modify entities, you can call [`$method=update`]($method.md#methodupdate). Sintaxe +Para adicionar e modificar entidades, você pode chamar [`$method=update`]($method.md#methodupdate). Sintaxe Besides retrieving a single entity in a dataclass using [\{dataClass\}({key})](dataClass.md#dataclasskey), you can also write a [class function](ClassFunctions.md#function-calls) that returns an entity selection (or a collection). -Before returning a selection, you can also sort it by using [`$orderby`]($orderby.md) one one or more attributes (even relation attributes). +Antes de devolver a coleção, também pode ordená-la utilizando [`$orderby`]($orderby.md) um ou vários atributos (mesmo os atributos de relação). ## Navegando dados @@ -35,7 +35,7 @@ To access the entity set, you must use `$entityset/\{entitySetID\}`, for example `/rest/People/$entityset/0AF4679A5C394746BFEB68D2162A19FF` -By default, an entity set is stored for two hours; however, you can change the timeout by passing a new value to [`$timeout`]($timeout.md). O timeout é continuamente resetado ao valor definido (seja o valor padrão ou um definido por você) a cada vez que for usado. +Por padrão, um conjunto de entidades é armazenado por duas horas; no entanto, você pode alterar o tempo limite passando um novo valor para [`$timeout`]($timeout.md). O timeout é continuamente resetado ao valor definido (seja o valor padrão ou um definido por você) a cada vez que for usado. Se quiser remover um conjunto de entidades do cache de 4D Server, você pode usar [`$method=release`]($method.md#methodrelease). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/application-server.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/application-server.md index 0efa303d84851c..9c73c94a778a5c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/application-server.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/application-server.md @@ -33,7 +33,7 @@ Si presiona el botón **Rechazar nuevas conexiones**: - O nome do projeto já não aparece na caixa de diálogo da ligação remota. - Os clientes de ambiente de trabalho que já estão ligados não são desligados e podem continuar a trabalhar normalmente. -> You can perform the same action with the [`REJECT NEW REMOTE CONNECTIONS`](https://doc.4d.com/4dv19/help/command/en/page1635.html) command. +> Você pode executar a mesma ação com o comando [`REJECT NEW REMOTE CONNECTIONS`](https://doc.4d.com/4dv19/help/command/en/page1635.html). - Si presiona el botón **Aceptar nuevas conexiones**, el servidor de aplicaciones vuelve a su estado por defecto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/users.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/users.md index c2b36ad2446a64..8c24faae495f1b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/users.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ServerWindow/users.md @@ -66,4 +66,4 @@ This button can be used to directly show the processes of the user(s) selected o Este botão pode ser utilizado para forçar a desconexão do(s) usuário(s) selecionado(s). When you click on this button, a warning dialog box appears so that you can confirm or cancel this operation (hold down **Alt** key while clicking on the **Drop user** button to disconnect the selected user(s) directly without displaying the confirmation dialog box). -> You can perfom the same action for remote users with the [`DROP REMOTE USER`](https://doc.4d.com/4dv19/help/command/en/page1633.html) command. +> É possível executar a mesma ação para usuários remotos com o comando [`DROP REMOTE USER`](https://doc.4d.com/4dv19/help/command/en/page1633.html). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/advanced-programming.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/advanced-programming.md index 46a3bf2d94cce7..b0cbf5fe77ecf3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/advanced-programming.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/advanced-programming.md @@ -12,7 +12,7 @@ Dado que 4D View Pro es alimentado por la [solución de hoja de cálculo SpreadJ Since 4D View Pro is a web area, you can select a webpage element and modify its behavior using Javascript. El siguiente ejemplo oculta la [cinta](./configuring.md#ribbon) spreadJS: ```4d -//Button's object method +//Método objeto do botão var $js; $answer : Text diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-add-formula-name.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-add-formula-name.md index d6249c5a7b505a..6d655dc2a3958d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-add-formula-name.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-add-formula-name.md @@ -24,7 +24,7 @@ O comando `VP ADD FORMULA NAME` retorna um novo objeto de intervalo que faz referência a uma célula específica. -> Este comando destina-se a intervalos de uma única célula. To create a range object for multiple cells, use the [VP Cells](vp-cells.md) command. +> Este comando destina-se a intervalos de uma única célula. Para criar um objeto de intervalo para várias células, use o comando [VP Cells](vp-cells.md). Em *vpAreaName*, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-get-workbook-options.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-get-workbook-options.md index 724c6dd7c26262..14a96d0fa6aa5d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-get-workbook-options.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-get-workbook-options.md @@ -25,7 +25,7 @@ Em *vpAreaName*, passe o nome da área 4D View Pro. O objeto devolvido contém todas as opções de workbook (padrão e modificadas) no workbook. -The list of workbook options is referenced in [`VP SET WORKBOOK OPTIONS`'s description](vp-set-workbook-options.md). +A lista de opções de pasta de trabalho é referenciada na descrição de [`VP SET WORKBOOK OPTIONS`](vp-set-workbook-options.md). #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-border.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-border.md index 807c4e3036d386..4dd35273bf5673 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-border.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-border.md @@ -56,7 +56,7 @@ VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option) #### Exemplo 2 -This code demonstrates the difference between `VP SET BORDER` and setting borders with the [`VP SET CELL STYLE`](vp-set-cell-style.md) command: +Esse código demonstra a diferença entre `VP SET BORDER` e a definição de bordas com o comando [`VP SET CELL STYLE`](vp-set-cell-style.md): ```4d // Set borders using VP SET BORDER diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formula.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formula.md index 0fc67ccd6fea54..dad6e91eb3ec0f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formula.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formula.md @@ -24,9 +24,9 @@ Em *rangeObj*, passe um intervalo de células (criado, por exemplo, com [`VP Cel The *formula* parameter specifies a formula or 4D method name to be assigned to the *rangeObj*. > If the *formula* is a string, use the period `.` as numerical separator and the comma `,` as parameter separator. -> If a 4D method is used, it must be allowed with the [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md) command. +> Se um método 4D for usado, ele deverá ser permitido com o comando [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md). -The optional *formatPattern* defines a [pattern](../configuring.md#cell-format) for the *formula*. +O *formatPattern* opcional define um [padrão](../configuring.md#cell-format) para a *fórmula*. You remove the formula in *rangeObj* by replacing it with an empty string (""). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formulas.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formulas.md index de0559a29e96fc..56b36e603b5946 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formulas.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-formulas.md @@ -26,7 +26,7 @@ O parâmetro *formulasCol* é uma coleção bidimensional: - Cada subcoleção define os valores das células para a linha. Values must be text elements containing the formulas to assign to the cells. > If the formula is a string, use the period `.` as numerical separator and the comma `,` as parameter separator. -> If a 4D method is used, it must be allowed with the [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md) command. +> Se um método 4D for usado, ele deverá ser permitido com o comando [`VP SET ALLOWED METHODS`](vp-set-allowed-methods.md). You remove the formulas in *rangeObj* by replacing them with an empty string (""). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-print-info.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-print-info.md index b58864f38ce14b..ee8a2c6517733e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-print-info.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-print-info.md @@ -21,7 +21,7 @@ The `VP SET PRINT INFO` command Passe o nome da área 4D View Pro a ser impressa em *vpAreaName*. Se passar um nome que não existe, é devolvido um erro. -You can pass an object containing definitions for various printing attributes in the *printInfo* parameter. To view the full list of the available attributes, see [Print Attributes](../configuring.md#print-attributes). +You can pass an object containing definitions for various printing attributes in the *printInfo* parameter. Para ver a lista completa dos atributos disponíveis, consulte [Atributos de impressão](../configuring.md#print-attributes). In the optional *sheet* parameter, you can designate a specific spreadsheet to print (counting begins at 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-text-value.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-text-value.md index 842d3b7903d14c..3a5c11b7c5901d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-text-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-text-value.md @@ -23,7 +23,7 @@ Em *rangeObj*, passe um intervalo de células (criado, por exemplo, com [`VP Cel The *textValue* parameter specifies a text value to be assigned to the *rangeObj*. -The optional *formatPattern* defines a [pattern](../configuring.md#cell-format) for the *textValue* parameter. +O *formatPattern* opcional define um [padrão](../configuring.md#cell-format) para o parâmetro *textValue*. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-time-value.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-time-value.md index 0ebc2c92de83f0..ddfd4684f97c35 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-time-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-time-value.md @@ -23,7 +23,7 @@ Em *rangeObj*, passe um intervalo de células (criado, por exemplo, com [`VP Cel The *timeValue* parameter specifies a time expressed in seconds to be assigned to the *rangeObj*. -The optional *formatPattern* defines a [pattern](../configuring.md#cell-format) for the *timeValue* parameter. +O *formatPattern* opcional define um [padrão](../configuring.md#cell-format) para o parâmetro *timeValue*. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-values.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-values.md index 63b25f978549de..b50a8c78fac060 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-values.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-values.md @@ -18,7 +18,7 @@ title: VP SET VALUES The `VP SET VALUES` command assigns a collection of values starting at the specified cell range. -In *rangeObj*, pass a range for the cell (created with [`VP Cell`](vp-cell.md)) whose value you want to specify. The cell defined in the *rangeObj* is used to determine the starting point. +Em *rangeObj*, passe um intervalo para a célula (criada com [`VP Cell`](vp-cell.md)) cujo valor você deseja especificar. The cell defined in the *rangeObj* is used to determine the starting point. > - If *rangeObj* is not a cell range, only the first cell of the range is used. > - If *rangeObj* includes multiple ranges, only the first cell of the first range is used. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-workbook-options.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-workbook-options.md index 1c6f7226b99b3b..57fba92e78379e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-workbook-options.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/ViewPro/commands/vp-set-workbook-options.md @@ -52,7 +52,7 @@ A tabela seguinte lista as opções de libro disponíveis: | calcOnDemand | boolean | As fórmulas só são calculadas quando são solicitadas. | | columnResizeMode | number | Modo de redimensionamento de colunas. Available values:| Constant | Value | Description |
|---|---|---|
| vk resize mode normal | 0 | Use normal resize mode (i.e remaining columns are affected) |
| vk resize mode split | 1 | Use split mode (i.e remaining columns are not affected) |
| Constant | Value | Description |
|---|---|---|
| vk copy paste header options all headers | 3 | Includes selected headers when data is copied; overwrites selected headers when data is pasted. |
| vk copy paste header options column headers | 2 | Includes selected column headers when data is copied; overwrites selected column headers when data is pasted. |
| vk copy paste header options no headers | 0 | Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted. |
| vk copy paste header options row headers | 1 | Includes selected row headers when data is copied; overwrites selected row headers when data is pasted. |
| Constante | Valor | Descrição |
|---|---|---|
| vk auto fill type auto | 5 | Preenche automaticamente as células. |
| vk auto fill type clear values | 4 | Clears cell values. |
| vk auto fill type copycells | 0 | Fills cells with all data objects, including values, formatting, and formulas. |
| vk auto fill type fill formatting only | 2 | Fills cells only with formatting. |
| vk auto fill type fill series | 1 | Fills cells with series. |
| vk auto fill type fill without formatting | 3 | Preenche as células com valores e sem formatação. |